Docker容器化FastAPI应用无法连接宿主机MySQL求助

核心问题定位 #

错误信息里的5da987ec678f是你的容器短ID，说明FastAPI应用的数据库连接配置中，host被错误指向了容器自身，而非宿主机的可访问地址，这是连接被拒绝的根本原因。

具体解决方案 #

1. 修正数据库连接配置 #

打开你的db.py，确保数据库连接的host字段设置为以下二者之一：

• 宿主机的Docker网关IP：默认网桥的网关通常是172.17.0.1，可通过docker inspect bridge | grep Gateway命令确认具体值
• 宿主机的真实内网/公网IP（比如服务器eth0网卡的IP）

绝对不要用localhost（容器内的localhost指向容器自身），也不要依赖自动获取的容器主机名。

2. 确认MySQL用户权限 #

确保你的数据库用户已授权从容器所在网段访问，执行以下SQL：

GRANT ALL PRIVILEGES ON 你的数据库名.* TO '你的用户名'@'%' IDENTIFIED BY '你的密码';
FLUSH PRIVILEGES;

（如果需要更严格的权限控制，可将%替换为容器所在的网段，比如172.17.0.%）

3. 验证容器内网络连通性 #

进入容器后，测试宿主机MySQL端口的连通性：

# 用telnet测试
telnet 宿主机IP 3306
# 或用nc测试
nc -zv 宿主机IP 3306

如果能连通，说明网络层面没问题，问题出在应用配置；如果不通，再次确认宿主机防火墙状态（你已确认无防火墙，此步可快速跳过）或Docker网络配置。

4. 可选：使用host网络模式测试（仅用于排查） #

如果上述步骤仍有问题，可尝试用host网络模式运行容器，让容器直接使用宿主机的网络栈：

docker run --network host 你的FastAPI镜像名

此时应用的数据库连接host设为localhost即可连接宿主机MySQL，此模式适合快速排查，但不推荐生产环境使用。

5. 检查环境变量覆盖 #

确认容器运行时没有通过环境变量覆盖db.py中的数据库连接配置，比如是否在docker run时传递了错误的DB_HOST变量。

内容的提问来源于stack exchange，提问作者NFeruch - FreePalestine