Docker启动了,应用为何仍连不上数据库

适用范围:Docker Compose V2;仅适用于由Compose编排的依赖,先核对部署方式。

数据库容器显示running,应用仍可能在启动时连接失败,过一会儿手动重启应用又正常。先看时间线:数据库进程启动、接受连接、完成迁移,与应用发起首次查询,可能不在同一时刻。

查看状态和同一时段日志

docker compose ps
docker compose logs --since 10m --timestamps db app

服务名按实际替换。日志可能有数据库名、地址和异常参数,提交前脱敏。先区分连接拒绝、认证失败、库不存在和表尚未迁移,不能全部归因于“启动慢”。

depends_on不一定等数据库就绪

简写依赖主要控制启动顺序。需要等待健康检查时,在现有配置中明确条件;下面仅展示片段:

services:
  app:
    depends_on:
      db:
        condition: service_healthy
  db:
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U \"$${POSTGRES_USER}\" -d \"$${POSTGRES_DB}\""]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s

这个例子适用于包含pg_isready、在容器内监听TCP 5432端口的PostgreSQL镜像,不能用于MySQL。先确认POSTGRES_USER和POSTGRES_DB在db容器中都已设置为实际值;端口不同时补上对应-p参数。-h 127.0.0.1明确检查容器内TCP入口,双美元符号避免Compose在宿主机阶段提前展开变量。镜像、网络、挂载和凭据沿用经过验证的项目配置,不要用该片段替换整份文件。[1][2]

pg_isready表明服务器是否接受连接,不证明业务账号可读写,也不证明迁移已完成;即使用户名或库名不正确,它仍可能判断服务器已就绪,同时服务器会记录连接失败。应用依赖的就绪条件应与真实启动要求一致。[2]

重启之后也要有重连逻辑

初次启动等待健康,不等于运行期间数据库重启后所有请求都能恢复。应用还应设置连接超时、有限重试及退避,并正确丢弃失效连接。

只重试明确安全的操作。请求结果不明的扣款、提交订单或写入任务不能盲目重放;应依靠幂等键或业务状态确认。

不靠固定sleep和删卷解决

固定等30秒可能今天够用、明天不够。更不要删数据库卷重新初始化来消除启动错误。先备份Compose文件,验证语法,再在独立测试环境重建相关服务。

验收至少包括全新启动、数据库慢启动、依赖短暂重启三种情况;确认应用没有重复执行迁移、任务或发信,重试上限耗尽时有明确日志和告警。生产变更安排窗口,并保留原配置与回退镜像。

继续排查

Docker应用连不上数据库:检查容器之间的连接;Docker显示unhealthy,服务为什么还在运行。

技术依据:[1] Docker Compose启动顺序与健康依赖;[2] PostgreSQL pg_isready说明。适用版本见本文说明。