Compose 里 app 依赖 mysql,写了 depends_on 就以为万事大吉。起容器之后 app 日志刷出一片 SQLSTATE[HY000] [2002] Connection refused,重启三四次才连上。同事说依赖都加了怎么还抢跑。
depends_on 管的是容器创建和启动的先后顺序,不管进程什么时候能接连接。mysql 容器 start 完那一瞬间,mysqld 还在初始化数据目录,3306 根本没监听。compose v2 默认条件是 service_started,要写 service_healthy 才会等健康检查,而健康检查本身得自己声明。
第一次改加上 condition: service_healthy,compose 直接报 invalid depends_on condition。原因是文件头还留着 version: "3",v3 语法里没有这个字段。删掉 version 那行再补 healthcheck 才跑起来。
参数也不能随手写。interval 5s,retries 10,start_period 给到 30s。就这 30 秒还翻过车,第一次启动要导 200 MB 的库,健康检查 20 秒判死,容器被标 unhealthy,app 干脆不启动。start_period 拉到 90s 才稳。
还有一层容易忽略:service_healthy 只保证检查通过那一刻,后面再抖它不管。有次 mysql 因为磁盘写满被杀掉重拉,app 连接池全是坏连接,PHP 报 MySQL server has gone away。应用侧的退出重试得留着。
services:
mysql:
image: mysql:8.0.36
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1"]
interval: 5s
timeout: 3s
retries: 10
start_period: 90s
app:
depends_on:
mysql:
condition: service_healthy
验证方法很土。docker compose down -v 清干净再 up,把 app 第一条连接错误的时间戳和 mysql 打印 ready for connections 的时间戳并排看,前者必须晚于后者,早一秒都算没配对。
另说一句,compose 文件的 version 字段现在只会打印 obsolete 警告,留着没意义。删掉之后 condition 才生效,这个坑我在两个项目上各踩了一次。
