Docker应用连不上数据库:检查容器之间的连接
数据库容器显示正在运行,应用却一直提示连接失败,先核对应用到底在连谁。应用和数据库放在两个容器里时,把数据库地址填成localhost,通常会让应用去找自己。
本文针对同一个Docker Compose项目、通过普通bridge网络连接的两个服务。以应用服务app和MySQL服务db为例;命令在服务器的项目目录执行,服务名换成实际名称。部署时若指定过-f文件或-p项目名,下面每条Compose命令也要沿用,避免查错项目。
连接地址先填对
应用应使用数据库的服务名和容器内部监听端口。服务名看Compose文件中services下面的键,不一定等于容器显示名称,也不需要固定数据库容器IP。
| 从哪里连接 | 这个示例应使用什么地址 |
|---|---|
| app容器内部 | db:3306,3306必须是MySQL实际监听端口。 |
| 服务器宿主机上的客户端 | 只有已经配置127.0.0.1:13306:3306这类映射时,才对应127.0.0.1:13306。这里仅解释已有映射,不要求新增。 |
容器之间正常通信不以发布数据库端口到公网为前提。不要因为应用连不上,就先开放公网3306。
确认两个服务真的在同一个网络
docker compose config --services
docker compose ps --all
docker compose logs --since 10m --tail 60 db app
先核对服务名、容器名称和状态。Exited或持续重启时,先处理对应服务日志中的启动错误。日志只查看近期片段;对外提供前,把密码、连接串、令牌和客户数据打码,不要直接发整份环境变量。
用ps结果里的两个实际容器名称替换下一条命令末尾的占位文字。它只输出容器名和所属网络名,不展开环境变量:
docker inspect --type container \
--format '{{.Name}}: {{range $name, $_ := .NetworkSettings.Networks}}{{$name}} {{end}}' \
'实际应用容器名' '实际数据库容器名'
两行至少应有一个共同的网络名称。没有交集时,检查Compose中的networks配置以及是否误用了另一个项目;不要临时把数据库接到所有网络。解析服务名失败可继续看容器内DNS排查。
从应用这一侧判断失败在哪一步
在数据库容器内部登录成功,只能说明它能访问自己。若应用容器已经带有mysql客户端,可从应用侧做一次只读连接测试;将账号app_user和库名appdb换成实际值,密码在提示后输入,不写在命令中:
docker compose exec app mysql --protocol=TCP --connect-timeout=5 \
-h db -P 3306 -u app_user -p -D appdb -e 'SELECT 1;'
客户端不存在时,命令找不到不等于网络故障,先使用应用自身的数据库连接日志,不必为这一步临时改业务镜像。若原连接要求TLS,应沿用相应客户端TLS参数,不关闭验证。
- 主机名无法解析:核对db是否为真实服务名、两边是否共享网络。
- 连接被拒绝或超时:核对内部端口、数据库监听和启动日志;超时还需检查现有网络限制。
- Access denied:已进入数据库认证阶段,核对应用实际读取的账号、密码和授权来源,继续开放端口不会修好认证。
- Unknown database:核对库名以及初始化是否完成,不能靠重新创建一个空库来替代原数据。
容器为Running不等于数据库已就绪。首次初始化或恢复数据时应看数据库日志;如确认是启动时序问题,再配置适合该数据库的健康检查,并让依赖等待service_healthy。应用在数据库运行中重启或断连后,仍需要自己的重连机制。
改完配置,再用应用做一次查询
备份原配置,只修改已经定位的连接项。下面只适用于改了app的主机名、端口等连接配置:数据库已正常运行、应用镜像已在本机且没有其他待发布改动时,可在维护时段只更新应用服务;这可能短暂中断应用。若修改了两个服务的网络成员,应单独安排相关服务的变更与复测,不套用只更新app的命令。
docker compose up -d --no-deps --no-build --pull never app
docker compose logs --since 5m --tail 60 app
这组参数不启动依赖服务、不构建或拉取新镜像。若本机缺少镜像会失败,应先核对原部署版本,不临时换成其他镜像。环境变量仍未生效时,参照Compose配置生效检查。
最后同时检查应用日志和一项真实的只读业务查询。SELECT 1成功只证明这次连接可执行简单SQL,不代表业务表、权限和应用配置全部正确;数据库认证报错可接着看MySQL连接错误排查。