Docker健康检查检测文件存在及等待文件创建的问题排查

我来帮你搞定这个问题——你的Docker健康检查命令写法有问题，导致没法正确判断文件是否存在。

问题根源 #

你在healthcheck的test字段里写了：

test: bash -c [ -f /tmp/a ]

在YAML语法里，不加引号的[ -f /tmp/a ]会被解析成一个数组，而bash -c需要接收单个字符串形式的命令参数，这就导致bash没法正确执行文件判断逻辑，健康检查自然一直处于starting状态。

正确的两种写法 #

你可以任选一种修改docker-compose.yml里的healthcheck部分：

写法1：用引号包裹完整命令（字符串形式）

healthcheck:
  test: "bash -c '[ -f /tmp/a ]'"
  timeout: 1s
  retries: 20

写法2：用数组形式传递命令参数（更推荐，避免shell转义问题）

healthcheck:
  test: ["bash", "-c", "[ -f /tmp/a ]"]
  timeout: 1s
  retries: 20

原理说明 #

[ -f /tmp/a ]是bash的文件存在判断命令：

• 如果/tmp/a存在，命令返回0，Docker会认为容器健康
• 如果文件不存在，命令返回非0，Docker会继续重试直到达到retries次数

测试验证 #

修改后执行以下步骤：

1. 重新构建并启动容器：docker-compose up --build
2. 等待5秒（你的容器命令里sleep 5后会创建/tmp/a）
3. 执行docker ps，就能看到容器状态变为Up ... (healthy)

内容的提问来源于stack exchange，提问作者deathangel908