容器与云原生 / 系统课时
数据库启动了为什么应用还连不上
数据库启动了为什么应用还连不上
docker compose ps 已显示数据库容器正在运行,应用却仍然报连接拒绝,这通常不是网络玄学,而是把“容器进程已启动”误当成了“数据库已经可以处理业务连接”。本课用一个可复现实验定位这段时间差,并给出可靠的启动顺序修复方式。
学习目标
- 区分容器
Running与数据库真正Ready的含义 - 用日志和数据库探针定位启动阶段的连接失败
- 使用健康检查把“先启动”升级为“等到可用再启动”
Running 只说明容器主进程还活着
Compose 启动数据库时,容器进入运行态只表示它的主进程已经开始执行。数据库镜像随后还可能创建数据目录、初始化系统表、执行初始化脚本、恢复日志并最终监听端口。应用如果在这段窗口内发起连接,就会遇到 connection refused、no response 或类似错误。
短语法 depends_on 解决的是创建和启动顺序:依赖服务先启动,再启动当前服务。它不会自动判断数据库是否已经能接受连接。因此“数据库容器先 Running”与“应用此刻一定能连上”是两个不同条件。

用延迟启动复现竞态
下面的 compose.yaml 故意让 PostgreSQL 在真正执行入口脚本前等待 15 秒。probe 只声明普通 depends_on,因此它会在数据库容器已经启动、但数据库尚未监听时立即探测。
services:
db:
image: postgres:18
entrypoint:
- /bin/sh
- -c
- sleep 15; exec /usr/local/bin/docker-entrypoint.sh postgres
environment:
POSTGRES_DB: appdb
POSTGRES_USER: app
POSTGRES_PASSWORD: demo-pass
probe:
image: postgres:18
depends_on:
- db
command:
- /bin/sh
- -c
- PGPASSWORD=demo-pass pg_isready -h db -U app -d appdb这份配置的关键点不是“睡眠”本身,而是人为放大真实数据库常见的初始化窗口,便于稳定观察问题。
在保存文件的目录执行:
docker compose down -v --remove-orphans
docker compose up --abort-on-container-exit --exit-code-from probe预期输出的关键行类似:
db:5432 - no response
probe exited with code 2不同 Compose 版本的日志前缀会不同,但探针在数据库 Ready 前返回非零状态这一结果应保持一致。
按数据库能力定位,而不是只看容器状态
遇到应用启动时报数据库连接失败,可以按“容器是否存在 → 数据库是否仍在初始化 → 数据库端口是否能接受连接”的顺序检查。先看服务状态和数据库日志,再从同一 Compose 网络中执行数据库自己的探针,比单看宿主机端口更接近应用真实连接路径。
docker compose up -d db
docker compose ps db
docker compose logs --tail=30 db
docker compose exec db pg_isready -U app -d appdb预期结果:在初始化阶段,ps 可以已经显示容器为 Up,而 pg_isready 仍可能报告未响应;初始化完成后,最后一条命令会变为:
/var/run/postgresql:5432 - accepting connections如果数据库探针已经成功而应用仍连不上,排查重点应转向服务名是否写成 db、连接端口是否使用容器端口、用户名和数据库名是否一致,以及应用是否和数据库处于同一网络。
让应用等待 service_healthy
修复启动竞态时,应把“Ready 的判定方式”写进数据库服务,再让依赖方等待该健康状态。下面是对前面配置的关键修改,属于片段示例,需要合并回同一个 compose.yaml。
services:
db:
healthcheck:
test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
interval: 2s
timeout: 2s
retries: 10
probe:
depends_on:
db:
condition: service_healthy$${...} 用于让 Compose 保留美元符号,使变量在容器内执行健康检查时再展开。此时 probe 不再只等待数据库容器启动,而是等待 pg_isready 成功。
重新执行完整实验:
docker compose down -v --remove-orphans
docker compose up --abort-on-container-exit --exit-code-from probe预期输出的关键结果为:
db:5432 - accepting connections
probe exited with code 0健康检查解决的是启动阶段的就绪协调,不应替代应用自身的重试机制。数据库可能在应用运行期间重启或短暂失联,因此生产应用仍应对连接建立、连接池恢复等瞬时故障设置有限重试和退避。
Ready 还要和业务需求对齐
pg_isready 能证明 PostgreSQL 已接受连接,却不能证明业务表已经完成迁移、种子数据已经写入或外部依赖已经准备好。若应用启动前必须先完成迁移,可以把迁移做成一次性服务,再让应用等待其成功结束;不要把所有业务初始化都塞进“端口能连通”这一层健康判断。
判断原则很简单:先明确应用启动前真正依赖的最低能力,再为这个能力选择探针。这样才能避免把 Running、端口已监听和业务完全可用混成同一个状态。