[Bug]: 502 undefine error

问题场景

用户在通过 Docker 部署 RAGFlow v0.22.1 后重启容器，访问前端页面时返回 502 错误。用户反馈该错误可能过一段时间自行恢复，但不确定如何查看日志来进一步排查。

报错原文

[Bug]: 502 undefine error

原因分析

按 Issue 讨论链的判断，502 通常表示前端（nginx）无法访问到后端服务。可能原因包括：

• 后端容器（如 ragflow-cpu 或 ragflow-gpu）尚未完全启动或运行异常；
• MySQL 容器仍在初始化，后端尚未就绪，日志中可能出现 DB is not ready yet；
• 数据库表缺失（例如 'rag_flow.sync_logs' doesn't exist）、MySQL 用户权限不足；
• 端口冲突或 .env 端口映射配置不一致；
• 后端启动参数或 nginx 期望的后端端口不匹配（评论中提到的 --enable-adminserver 与 ADMIN_SVR_HTTP_PORT）；
• 容器崩溃并留下异常堆栈。

以上除“容器未就绪导致短时 502”外，其余均为可能原因，需要结合日志确认。

环境排查

• 确认使用的 RAGFlow 镜像版本（Issue 中为 v0.22.1）。
• 运行 docker ps 或 docker compose ps，确认 ragflow-cpu、ragflow-gpu、mysql 以及可能独立运行的 nginx 容器是否处于运行/健康状态。
• 检查后端与 MySQL 容器日志，关注数据库未就绪、表不存在、权限错误、端口冲突、崩溃堆栈等关键字。
• 若使用默认卷挂载，可在宿主机 ./ragflow-logs 目录查找 RAGFlow 日志。
• 核对 .env 中的端口映射，确认没有其他服务占用相同端口。
• 评论提到的后端启动参数与 ADMIN_SVR_HTTP_PORT（默认 9381）是否与 nginx 配置一致，可作为可能原因检查。

解决步骤

1. 先等待几分钟，观察 502 是否自行恢复；若恢复，说明多为数据库初始化期间后端尚未就绪。
2. 运行 docker ps 或 docker compose ps，确认各容器是否处于运行状态，排除容器未启动或频繁重启。
3. 对后端容器与 MySQL 容器分别查看日志：docker logs <container_name>；也可用 docker compose logs 查看全部容器日志。
4. 若未能通过容器日志定位，检查宿主机 ./ragflow-logs 目录下的 RAGFlow 日志。
5. 在日志中查找 DB is not ready yet、表不存在（如 'rag_flow.sync_logs' doesn't exist）、权限错误、端口冲突或崩溃堆栈。
6. 若出现数据库相关错误，确认 MySQL 容器健康，并确认 MySQL 用户具备建表权限；必要时等待数据库初始化完成后再访问。
7. 若问题持续，核对 .env 的端口映射与后端启动参数，确认端口未被其他服务占用；评论提到的 --enable-adminserver 与 ADMIN_SVR_HTTP_PORT 可优先尝试核对是否与 nginx 预期一致。

验证方法

重新访问前端页面，确认不再出现 [Bug]: 502 undefine error；同时检查后端与 MySQL 容器日志中不再出现数据库未就绪、表缺失、权限或端口冲突等错误，容器状态保持稳定运行。

参考来源

infiniflow/ragflow #13025

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。