Docker Compose部署官方Nginx容器健康检查不自动执行问题求助

这种情况我之前排查过好几次，咱们一步步来定位问题并解决：

1. 先检查Docker Compose配置的缩进是否正确 #

这是最容易踩的坑！如果你的healthcheck配置没有缩进在nginx服务块下面，而是和services平级，Docker Compose会完全忽略这个配置，容器自然不会自动执行健康检查。

正确的配置格式应该是这样的：

services:
  nginx:
    image: nginx:latest
    # 其他配置（端口、挂载等）
    healthcheck:
      test: ["CMD-SHELL", "/path/to/your/healthcheck.sh"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

你可以先核对自己的配置层级，确保healthcheck是nginx服务的子项。

2. 确认容器是否真的加载了健康检查配置 #

如果缩进没问题，用以下命令查看Nginx容器的详细信息：

docker inspect <你的nginx容器名称或ID>

在输出中查找Healthcheck字段：

• 如果找不到这个字段，说明配置没被正确加载，检查yaml语法（比如有没有漏写冒号、引号是否配对）。
• 如果能找到，查看LastExitCode和LastOutput，这里会显示健康检查执行的结果和错误信息，能帮你定位具体问题。

3. 检查健康检查命令在容器启动环境中的可用性 #

你说手动运行脚本正常，但容器启动时是用的官方镜像默认环境，可能存在以下差异：

• 脚本权限：如果脚本是挂载到容器里的，要确保它有执行权限（可以在挂载时加上chmod +x，或者在command里先执行权限设置）。
• 依赖工具缺失：官方Nginx的Alpine版本默认没有curl，如果你的脚本用了curl，手动进容器时可能自己安装了，但容器启动时是默认状态，会导致执行失败。可以改成用镜像自带的工具，比如wget或者nc：

  # 用wget的示例
  test: ["CMD-SHELL", "wget --spider --quiet http://localhost/ || exit 1"]
  # 或者用nc检查端口监听
  test: ["CMD-SHELL", "nc -z localhost 80 || exit 1"]
  

4. 调整健康检查的启动等待时间 #

Nginx启动需要一定时间，如果start_period设置得过短，第一次健康检查会失败，虽然Docker会重试，但有时候会被误认为“不执行检查”。可以把start_period调整到60s左右，给Nginx足够的启动时间：

start_period: 60s

5. 检查Docker Compose版本 #

如果你的Docker Compose版本太老，可能对健康检查的某些参数支持有问题，建议升级到最新的稳定版，避免兼容性问题。

按照上面的步骤排查，应该能找到问题所在并解决。

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