[Question]: dependency failed to start: container ragflow-mysql is unhealthy

问题场景

用户在使用 docker compose 启动 RAGFlow 时，MySQL 容器启动失败，健康检查不通过，导致依赖它的 ragflow-server 容器无法正常启动。

报错原文

✘ Container ragflow-mysql              Error
✔ Container ragflow-server             Created
dependency failed to start: container ragflow-mysql is unhealthy

原因分析

从 MySQL 日志看，报错指向 Table 'mysql.component' doesn't exist 和 Table 'mysql.user' doesn't exist，说明 MySQL 数据目录没有被正确初始化，或者目录中存在不完整的初始化数据。可能原因包括：

• 首次启动时 MySQL 初始化被中断，导致系统表未创建完整。
• 之前启动失败留下的残留数据影响了后续初始化。
• 已有数据目录与当前 MySQL 版本不兼容，属于迁移问题。

环境排查

• 确认 Docker 和 Docker Compose 版本。
• 确认 ./volumes/mysql_data 目录是否存在以及内容是否完整。
• 确认 MySQL 日志中是否有更早的初始化错误记录。
• 检查是否有其他容器占用 MySQL 端口或资源。

解决步骤

1. 先停止所有 RAGFlow 相关容器：docker compose -f docker/docker-compose.yml stop。
2. 删除自动创建的 MySQL 数据目录：rm -rf ./volumes/mysql_data。
3. 重新启动服务：docker compose -f docker/docker-compose.yml up -d。
4. 如果问题依旧，可尝试等待 1-2 分钟后再次执行 docker compose -f docker/docker-compose.yml start，因为 MySQL 8 在某些环境下初始化较慢。
5. 如果仍失败，检查最新 MySQL 日志确认是否还有其他初始化错误。

验证方法

执行 docker compose ps 查看容器状态，确认 ragflow-mysql 显示为 healthy，且 ragflow-server 正常启动。也可以通过 docker logs ragflow-mysql 查看日志，确认没有报错信息。

参考来源

infiniflow/ragflow #7501

AI 工具推荐

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

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

了解 GamsGo AI

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