[Question]: Why cant i connect to MySQL

快速结论：RAGFlow 在 Docker 中无法连接 MySQL，最常见原因是数据库主机地址配置错误——在 Docker 环境下应使用服务名（通常是 mysql）而不是 localhost。优先检查 service_conf.yaml 或环境变量中的 MYSQL_HOST 配置。

适用环境：RAGFlow v0.19.0 slim，Docker 部署；操作系统和 Python 版本未在 Issue 中明确说明。

最快修复方案：暂无确认的一步修复方案。Issue 中给出的是配置排查方向，最优先尝试将 MySQL 主机地址从 localhost 改为 mysql（Docker 服务名），并确保所有容器在同一 Docker 网络中。

注意事项：该方案来自 Issue 维护者的经验性回答，并非用户实测验证结果；SELinux、容器网络、数据卷状态等都可能影响最终效果，需逐项排查。

问题场景

用户使用 Docker 启动 RAGFlow v0.19.0 slim 版本，尝试让 RAGFlow 连接 MySQL 数据库时失败。用户确认通过 Python 脚本可以直接连接同一个 MySQL 实例，但 RAGFlow 容器内部始终无法建立数据库连接。

报错原文

[Question]: Why cant i connect to MySQL

原因分析

根据 Issue 维护者的分析，最可能的原因是 Docker 容器网络环境下的 MySQL 主机地址配置错误。在 Docker 中，localhost 指向的是 RAGFlow 容器自身，而不是宿主机或其他容器。如果配置文件中将 MySQL 主机设置为 localhost，RAGFlow 会在自己容器内部寻找 MySQL 服务，这通常不存在，导致连接失败。

可能原因还包括：

RAGFlow 与 MySQL 不在同一个 Docker 网络（默认应为 ragflow 网络）
SELinux 权限限制导致数据卷挂载异常
MySQL 数据卷已损坏或初始化不完整

环境排查

确认 Docker 容器是否在同一网络：docker network ls 检查是否存在 ragflow 网络
检查 RAGFlow 的 service_conf.yaml 中 MySQL 主机配置是否为 mysql 而非 localhost
确认环境变量 MYSQL_HOST 是否设置为 mysql
检查系统是否启用 SELinux（getenforce 命令），若为 Enforcing 则需处理数据卷挂载权限
确认 MySQL 端口映射是否正确，默认应为 3306

解决步骤

检查 service_conf.yaml 或 Docker 环境变量，将 MySQL 主机地址改为 mysql（RAGFlow 的 Docker 服务名）
确认所有容器在同一个 Docker 网络（默认为 ragflow 网络）：docker network inspect ragflow 查看容器是否都在其中
修改配置后重启 RAGFlow 相关服务，使配置生效
若系统启用 SELinux，在 docker-compose.yml 中为数据卷挂载添加 :z 后缀（如 - ./init.sql:/data/application/init.sql:z），避免权限问题
如果以上步骤无效，可尝试清理 MySQL 数据卷并重新初始化，让 RAGFlow 自动重建数据库表结构
若持续无法解决，可尝试将 MySQL 替换为 MariaDB 作为备选方案（此方案来自其他 Issue 的用户反馈，未在本 Issue 中实测）

验证方法

配置修改并重启服务后，访问 RAGFlow 的 Web 界面，确认系统能正常加载和显示数据；或者在 RAGFlow 容器内手动执行 mysql -h mysql -P 3306 -u root -p 测试到数据库的网络连通性。若 RAGFlow 能正常完成初始化并进入登录页面，说明 MySQL 连接已恢复。