浏览 AI 知识库
AI 上传文件失败怎么办：区分超时、限流和登录失效
大文件上传失败时，先保存文件大小、错误码、时间和客户端状态。超时、限流和登录失效要分开处理，连续重试只会把现场搅在一起。
进度停在 96% 以后又出现 401，文件真的坏了吗
上传一个 180MB 扫描 PDF 时进度停在 96%。连续重试三次后又遇到登录失效，用户以为文件坏了，开始重新安装客户端。
- 错误码、时间、文件特征和复现条件已记录
- 每次只改变一个条件
- 重试次数、停止条件和替代方案明确
AI 上传文件失败，先从“文件无法上传”这一类现象查起
文件无法上传
- 原因
- 格式、大小、损坏、文件名、权限或浏览器状态不符合。
- 怎么改
- 用小的已知文件测试，核对当前支持格式与上限，必要时重新导出但保留原件。
处理中超时
- 原因
- 文件过大、任务复杂、网络中断或服务端处理超出时限。
- 怎么改
- 缩小批次、固定页码和检查点；先确认上一次是否产生结果再重试。
出现 429
- 原因
- 账号、模型、并发或时间窗限流。
- 怎么改
- 停止并发和立即重试，读取重试提示，按退避或等待；记录发生频率。
登录失效或无权限
- 原因
- 会话过期、账号切换、组织/项目范围或资源权限变化。
- 怎么改
- 确认当前账号和目标资源，重新认证后用低风险读取验证，不清空未知数据。
复测前，固定原始现象、环境和目标
| 需要确认 | 本例内容 |
|---|---|
| 现有材料 | 文件可在本地打开，共 612 页；网络上传其他小文件正常；第一次失败为超时，第四次返回 401。 |
| 不能越过的边界 | 不连续重试消耗限额；先记录时间、文件大小、客户端和完整错误；敏感文件不转传未知工具。 |
| 要交付的结果 | 故障分类与处置记录 |
同一个‘上传不了’，要按实际症状分开处理
| 时间/症状 | 原始证据 | 先做什么 | 停止条件 |
|---|---|---|---|
| 09:10 文件被拒 | 413，文件 28 MB，限制 20 MB | 用原文件副本压缩或拆批，保留原件 | 不覆盖唯一原件，不反复上传同一大文件 |
| 09:18 处理超时 | 任务仍显示处理中，未确认是否产生结果 | 查询任务状态并等待检查点 | 状态未知时不重复创建任务 |
| 09:25 连续 429 | 响应含 Retry-After 60 | 停止并发，等待退避窗口 | 不继续立即重试 |
| 09:40 页面回到登录 | 会话失效，目标项目未确认 | 重新认证后先做低风险读取 | 不在账号不明时删除或重传 |
状态码和限制值仅为示例；真实处置以当前服务响应、控制台和官方限制为准。
AI 上传文件失败：按原条件复测的结果
原始现象
同一个大文件反复上传，错误从超时变成 401，无法判断原始故障层。
故障分类与处置记录
诊断记录分成两件事：先重新登录解决 401；再确认平台文件上限与 OCR 状态。将文件按章节在本地拆为 6 份并保留页码映射，第一份上传成功后才继续；若平台明确不支持该大小则改用本地提取。