选择简历后，点击“开始上传”按钮出现“请求失败，请重试”的错误

[eisly]

[Snailclimb]

No description provided.

“请求失败，请重试”是前端的兜底错误提示，说明后端返回了异常但前端没有解析到具体的错误信息。按可能性从高到低列一下：

最常见的原因：

1. 后端服务没启动或没完全启动。前端请求打到后端，但 Spring Boot 还在启动中或者根本没跑起来，Tomcat 返回的是 HTML 格式的错误页面，前端解析不到 JSON 格式的错误信息，就显示兜底文案。检查一下后端控制台有没有报错，确认服务已经正常运行。

2. 基础服务没就绪。上传简历需要 PostgreSQL、Redis、对象存储（MinIO/RustFS）都在线。如果其中任何一个连不上，后端会抛异常。最常见的是忘了启动 MinIO/RustFS，导致文件存储失败。建议先确认 Docker 容器都在运行：docker compose ps 看一下各个服务的状态。

3. 对象存储的 Bucket 不存在。项目启动时会自动创建 interview-guide 这个 Bucket，但如果 MinIO/RustFS 是后启动的，或者启动时创建失败，上传时就会报存储错误。

不太常见但也会遇到的原因：

4. 文件格式不对。前端接受 .pdf, .doc, .docx, .txt，但后端用 Apache Tika 做了真实的 MIME 类型检测。如果你把一个图片文件强行改后缀为 .pdf，Tika 会识别出来，直接拒绝。这种情况下会显示具体的“不支持的文件类型”错误，而不是兜底的“请求失败”。

5. 文件是扫描版 PDF。如果 PDF 是扫描件（纯图片，没有文字层），Tika 提取不出文本内容，会返回“无法从文件中提取文本内容”。这种情况正常会显示具体提示，但如果 Tika 解析过程中直接抛了异常，可能被前端的兜底逻辑捕获。

6. 文件超过 10MB。简历上传的文件大小限制是 10MB（不是知识库的 50MB），超过会被拦截。正常会显示“文件大小超过限制”，但如果 Spring 在 multipart 解析阶段就拒绝了，可能返回的不是标准 JSON 格式，前端就会显示兜底文案。

7. 触发限流。上传接口有速率限制（每分钟最多 5 次），如果频繁上传会触发限流。

排查建议：

先打开浏览器开发者工具（F12），切到 Network 标签，重新上传一次，看 /api/resumes/upload 这个请求的响应状态码和返回内容。如果是 502/504，说明后端或中间件挂了；如果是 413，是文件太大被 Spring 直接拦了；如果是 500 且返回的是 HTML 页面，说明后端启动不完整。把响应内容贴出来，基本就能定位具体原因了。

[MAX0MAX]

大概率是docker的数据库没启动起来