Compose应用先于PostgreSQL就绪导致连接失败:healthcheck与service_healthy配置记录

简介: 本文详解Docker Compose冷启动时`connection refused`根因:`depends_on`仅保启动顺序,不等数据库就绪。通过为DB配置`healthcheck`+应用侧使用`condition: service_healthy`,实现真正依赖等待,避免手动重启“修复”。(239字)

假设一台ECS上第一次执行docker compose up -d,应用日志很快出现connection refused;过一会儿手动docker compose restart app,又能正常连接。数据库没有问题,问题出在启动时机:Compose默认只等依赖容器启动,不等数据库可以接受连接。

本文依据Docker Compose和Dockerfile官方文档整理启动顺序的配置与验证方法,未在云实例内运行;服务名、账号和时间参数均为示例,需要按实际环境调整。

1. depends_on短写法只等“已启动”

很多项目里是这样写的:

services:
  app:
    depends_on:
      - db

官方说明是:短写法保证依赖服务先创建、先启动,但不等待依赖服务“健康”。PostgreSQL容器进程起来之后,还要完成初始化或恢复,才开始接受连接;这段时间里应用发起的连接就会失败。

这也解释了“手动重启一次就好了”:第二次启动时数据库早已就绪。问题只在冷启动、主机重启或首次部署时出现,所以容易被当成偶发故障。

2. 给数据库加healthcheck

services:
  db:
    image: docker.1ms.run/library/postgres:18.6-alpine
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: ${
   DB_PASSWORD:?缺少DB_PASSWORD}
      POSTGRES_DB: app
    volumes:
      - pgdata:/var/lib/postgresql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 10s
      timeout: 10s
      retries: 5
      start_period: 30s
volumes:
  pgdata:

几处要点:

  • 镜像通过docker.1ms.run获取,保留官方library命名空间和18.6-alpine固定标签,避免浮动标签让不同机器跑出不同版本。
  • $${POSTGRES_USER}`中的`$$让Compose不做插值,原样交给容器内的Shell,由容器里的环境变量展开。写成单个$,Compose会在宿主机侧替换,宿主机没有这个变量时就变成空值。
  • 健康状态最初是starting,检查通过后变为healthy,连续失败达到retries次后变为unhealthy。
  • start_period给首次初始化留出时间,期间的失败不计入重试次数;但只要在这段时间里成功一次,后续失败就开始计数。

参数怎么估:大致按“start_period+interval×retries”算出最长等待时间,示例约80秒。首次初始化数据较多或磁盘较慢时,先放大start_period,不要把timeout调得过短:单次检查超过timeout就算失败。

3. 应用侧改成等待service_healthy

services:
  migrate:
    image: 替换为应用镜像及固定标签
    command: ["替换为数据库迁移命令"]
    depends_on:
      db:
        condition: service_healthy
  app:
    depends_on:
      db:
        condition: service_healthy
        restart: true
      migrate:
        condition: service_completed_successfully

condition: service_healthy让Compose在db健康后才创建依赖它的服务。项目有数据库迁移时,可以把迁移拆成一次性服务,用service_completed_successfully要求它成功退出后再启动应用;迁移失败时应用不会带着旧表结构启动。没有迁移步骤的项目,去掉migrate相关两段即可。

restart: true表示通过Compose操作更新或重启db时,app也会跟着重启,重新建立连接;它不覆盖容器运行时因崩溃触发的自动重启。该字段在Compose 2.17.0引入,旧版本需要先升级。

compose-change-map.png

4. 验证与边界

docker compose config --quiet && echo '配置解析通过'
docker compose up -d --wait --wait-timeout 180
docker compose ps
db_cid=$(docker compose ps -q db)
docker inspect --format '{
   {json .State.Health}}' "$db_cid"

--wait会等服务进入运行或健康状态后再返回,适合放在部署脚本里;等待超时或依赖失败时命令会报错退出,脚本可以据此停下,不必再用固定的sleep猜时间。docker compose ps中db显示为健康后,app才会被创建;State.Health里能看到最近几次检查的输出和退出码,检查失败时先看这里。

这套配置也有边界:

  1. pg_isready只说明数据库在接受连接,不证明业务账号、库表或迁移已经就绪;迁移由上面的一次性服务负责。
  2. 健康检查只控制Compose启动这一刻。数据库在运行中重启时,应用仍需要自己的连接重试。
  3. 依赖服务被判为不健康时,up会报依赖启动失败,这时先看数据库日志,不要直接加大重试次数掩盖问题。

记录时我会保留三项:docker compose ps的健康状态、State.Health最近一次输出、应用首次成功连接的时间。三项都有,才能说启动顺序问题已经处理。

相关文章
|
27天前
Ubuntu22扩容磁盘到根目录
Ubuntu22扩容磁盘到根目录
205 1
|
27天前
|
人工智能 自然语言处理 测试技术
基于 JEV 的 UI 自动化改造实践:从页面探索到失败修复
最近讨论度很高的 AI 模型: JEV 。 它和常见的大模型不太一样。ChatGPT、Claude 这类模型更擅长对话、生成文本、写代码、解释问题;JEV 的定位更窄一些,主要用来做判断。调用接口后,它会根据输入内容返回结构化结果,程序可以直接读取这个结果,再决定下一步怎么执行。 这个特点很适合放在自动化流程里。 以 UI 自动化测试为例,传统脚本通常是提前写好步骤:点击哪个按钮、输入什么内容、断言哪个元素出现。只要页面结构稳定,这种方式没有问题。但在实际项目里,页面经常会出现一些不确定情况: 同一个业务入口在不同环境里文案不完全一致; 页面上有多个相似按钮,需要判断应该点哪一个; 执行失败后
112 1
|
27天前
|
自然语言处理 安全 Windows
UI Composition 在 Win32 窗口中绘制字体图标
本文介绍如何在Win32中通过DirectWrite动态加载嵌入式字体资源(RT_RCDATA),构建自定义字体集合与多语言文本格式映射,实现跨平台一致的文本渲染,无需分发字体文件。使用DraftDepot一键发布。
46 0
|
27天前
|
人工智能 算法 定位技术
Geo优化中,视频内容常踩的七个坑与规避方法
视频能否被生成式AI引用,关键不在画面质量,而在是否配备机器可读、可定位、可验证的文本层——包括精准字幕、结构化数据、章节时间戳及独立文字稿。文中梳理七大常见误区,直击“有内容却无引用”的核心症结。
119 0
|
27天前
|
安全
移动即时通信平台上的虚假招聘诈骗手法分析
本文剖析以虚假招聘为诱饵、引流至WhatsApp等私密即时通信平台实施的社会工程诈骗。聚焦“接触—转移—侵害”三阶段链条,揭示其利用移动端信任生态与求职者心理缺口的双重机制,强调“平台转移”是构建信任、规避监管的关键环节,并从用户识别、平台治理、行业协同三方面提出防御路径。(239字)
80 0
|
27天前
|
人工智能 定位技术
西安的 GEO 优化公司怎么挑:把「本地化」拆成可验证的交付证据
GEO(生成式引擎优化)是让AI精准引用机构公开材料的技术方法。当问题含“西安”等地域词,需处理“地域+行业+场景”复合意图——关键看其是否具备本地材料识别、信源对接与现场交付能力。本文提供可落地的核验路径:查问句集四行结构、验办公地址、溯信源渠道、核案例三匹配等,助您识别真本地化服务。(239字)
|
27天前
|
数据采集 人工智能 自然语言处理
2026年评论私信聚合回复技术落地指南:核心能力拆解、选型避坑与成本核算
国内内容运营领域正从单平台单点运营阶段向跨平台矩阵化、全链路智能化运营阶段加速演进,评论私信作为用户与运营主体直接交互的核心触点,其管理效率与响应质量已经成为影响账号流量权重、线索转化效率、品牌用户口碑的关键变量。本文将从核心技术能力拆解、选型避坑逻辑、落地成本核算三个维度展开系统盘点,定位为面向运营从业者、企业技术负责人的实操型科普内容,以评论私信聚合回复的典型落地形态为示例,说明各项技术的实际表现形式与选型注意点。文中出现的各类平台与方案仅作技术逻辑举例,不代表任何推荐顺序。
|
27天前
|
网络协议 定位技术 数据库
IPv6单栈与去NAT:IP定位逻辑从“推测”走向“解析”的架构演进
IPv6正从政策驱动迈向单栈演进与“网络去NAT”实践,推动IP定位由IPv4时代的“猜位置”转向IPv6的“读前缀线索”。双栈过渡期需重点保障IPv4/IPv6定位一致性,依赖高覆盖、快更新的双栈IP库(如IP数据云)开展实测验证。(239字)
118 0
|
27天前
|
存储 弹性计算 监控
商协会活动报名峰值,用阿里云函数计算 FC 做弹性扩容
商协会年会报名等场景流量呈脉冲式爆发,函数计算(FC)弹性扩缩容能力完美匹配:峰值自动扩容、闲时缩容至零,按调用计费,成本大幅降低;配合API网关限流鉴权、表格存储原子操作与幂等设计,兼顾高并发稳定性与会员体验。(239字)
|
26天前
|
缓存 网络安全 Docker
eMudhra证书事件:核对Compose挂载的CA文件与应用配置
eMudhra证书事件揭示容器中CA信任链风险:镜像更新CA后,若Compose只读挂载宿主机旧证书目录,应用仍会使用过期文件。本文详解挂载路径、环境变量(SSL_CERT_FILE/DIR、REQUESTS_CA_BUNDLE)与实际读取差异,提供只读检查、单文件挂载及摘要核验方法,强调“镜像CA、挂载CA、运行时CA”三者需明确区分。(239字)