Safew 上传卡在 0% 常见原因有：网络或代理阻断、浏览器扩展/缓存干扰、前端分片或进度回调异常、后端接收限制（如 client_max_body_size）、或上传凭证/跨域问题。按顺序换网、换浏览器无痕、查看浏览器控制台与 Network、用 curl/POSTMAN 直连接口、检查服务器日志与配置，通常能在 10–30 分钟内定位到问题并找到可行临时解决方案。
先说结论（为什么会卡在 0%）
把复杂问题拆成几块来想，就像检查一辆不开的车：先看油路（网络）、再看点火（浏览器/客户端）、再看引擎（服务器）。上传显示 0%，意思是浏览器还没收到真实的“开始上传”反馈，或虽然客户端发起了请求但进度事件从未触发，或者请求被拦截/失败在发出前就被阻止了。
最常见的几类原因
- 网络与代理问题：公司网络、VPN、代理或防火墙会阻止直连或者分块请求。
- 浏览器端问题：扩展、Service Worker、缓存、浏览器安全策略或过时的浏览器导致进度回调失效。
- 跨域与认证：上传使用预签名 URL 或需要 token，若凭证过期或 CORS 设置不当，浏览器会阻断请求。
- 服务器端限制：Nginx/Apache 的 body 大小限制、超时或反向代理配置会直接导致上传无法正常开始。
- 分片/断点续传实现问题：前端分片逻辑、分片大小配置或分片合并接口出错，会使进度停在 0%。
- 客户端库或 SDK 问题：第三方 SDK 的 bug、竞争请求或未正确处理进度事件。
按步骤排查（从最容易到最深入）
1. 先做快速排除（1–5 分钟）
- 换网络：从公司网络切到手机热点或家用网络。
- 换浏览器或开无痕：Chrome/Edge/Firefox 无痕模式，或使用另一个机器。
- 关掉扩展和安全软件：临时禁用广告拦截、隐私插件和本地杀毒、网关安全扫描。
- 试小文件：上传 1 KB 或 1 MB 的小文件，看是否能开始。
2. 查看浏览器开发者工具（5–15 分钟）
- 打开 Network 面板，点击上传动作，观察是否有请求发出（状态码、方法、URL）。
- 若没有请求：看 Console 是否有跨域错误（CORS）、Mixed Content、证书错误或安全异常。
- 若有请求但卡住：查看 Request Headers、Response Headers、Content-Length、Transfer-Encoding、以及请求持续时间。
- 观察是否有 OPTIONS 预检请求失败（常见于跨域请求或 PUT/DELETE/自定义头时）。
3. 用命令行工具直接调用接口（10–30 分钟）
用 curl 或 POSTMAN 可以绕开浏览器，直接验证后端是否能接收请求：
- 简单测试 GET/HEAD：curl -I https://upload.example.com
- 模拟上传：curl -v -F “file=@small.txt” https://upload.example.com/upload
- 若后端是预签名 URL（S3 类）：curl -v -T small.txt “https://s3-presigned-url…”
开发者角度的深入排查清单
服务器与代理配置
- Nginx: 检查 client_max_body_size、client_body_timeout、proxy_read_timeout、proxy_buffering。若使用上传分片，通常需要关闭 proxy_buffering 并增大超时时间。
- Apache: 检查 LimitRequestBody、Timeout、mod_security 规则是否拦截。
- 反向代理/CDN: 某些 CDN 会缓存或拒绝大请求，请确认直连或把上传绕过 CDN。
认证与签名问题
预签名 URL 和短期 token 很常见，尤其在移动端与对象存储交互时：
- 确认 token/签名在请求发起时仍然有效，时钟偏差会造成签名无效。
- 若使用跨域 Put/POST，确认 Access-Control-Allow-Origin 与 Access-Control-Allow-Methods 设置正确，且允许所需自定义头。
分片上传（multipart / chunked / resumable）
分片上传有两个常见失败点：前端分片发送失败，或服务器端合并失败。检查：
- 分片大小配置与后端允许的大小是否一致。
- 分片的编号、总数、校验（md5/sha）是否按协议发送。
- 服务端是否有未处理的并发问题或数据库事务阻塞合并操作。
常见网络/错误码与含义（方便对照）
| 状态/症状 | 可能原因 | 快速应对 |
| 无请求发出（Network 没条目） | 前端拦截、JS 错误、Service Worker、CSP | 查看 Console，禁用 Service Worker，检查 CSP/JS 错误 |
| OPTIONS 失败 / 预检报错 | CORS 配置不完整或认证头被拒 | 补齐 Access-Control-Allow-*，允许预检方法与头 |
| 401 / 403 | 凭证过期或权限问题 | 刷新 token，检查权限/签名 |
| 413 Payload Too Large | 服务器限制请求体大小 | 调整 client_max_body_size / LimitRequestBody，或分片上传 |
| 5xx（尤其 502/504） | 后端超时、代理无法连接或后端服务崩溃 | 查看服务器日志，增大超时或优化后端处理 |
实战技巧：一步步定位要做的操作
- 用户端先做：换网、换浏览器、开无痕、禁用扩展、试小文件。
- 开发者端再做：复制浏览器请求到 curl，确认服务器是否能接收；查看后端 access/error 日志时间点对应请求；检查中间层（负载均衡、CDN、WAF）日志。
- 如果使用云存储（S3/Azure/GCS）：确认 CORS、签名有效期、multipart 上传 API 使用正确。
- 临时变通方案：提供网页版外的上传方式（桌面客户端或分片更小的上传）、或让用户先压缩/拆分文件上传。
常见误区和容易忽略的小细节
- 以为“0%”就是前端进度条 bug：很多时候确实是后端尚未接收或被防火墙丢弃。
- 忽视浏览器安全限制：某些浏览器在隐私模式下默认阻断第三方 Cookie 或跨站请求。
- 误判 CDN 为原点问题：CDN 报错常被错误解读为服务器问题，实际上是边缘节点配置问题。
- 忽略时钟不同步：签名与证书验证对时间敏感，服务器与客户端时钟偏差会导致认证失败。
给产品/运维的建议（让用户尽快恢复上传）
- 在上传页面显示清晰的错误信息和诊断按钮（“查看控制台”“复制请求”、“联系客服”）。
- 实现上传回退策略：若网页上传失败，提供小文件分片自动重试或客户端下载上传。
- 收集足够日志：客户端应把失败时的请求 ID、时间戳、用户网络类型上传到错误收集系统，便于运维快速定位。
说到这里，可能你已经能按顺序把问题缩小到某一层：先用最简单的方式确认是网络、浏览器还是服务器的问题；如果是服务器，日志通常会告诉你为什么请求没有被接收；如果是浏览器或网络，替换环境与命令行请求能迅速确认。试过这些步骤后仍然卡住，可以把浏览器 Network 的抓包（包含 Request/Response headers 和报错代码）与服务器端的时间点日志一起发给运维同事，通常就能很快把“0%”这个表象拆开看清本质。