Docker Compose健康检查为何需额外使用sh -c？MySQL场景解惑

在Swarm模式下直接用CMD-SHELL执行mysqladmin ping作为MySQL健康检查会触发shutdown，本质是命令执行环境的差异和Swarm的特殊解析逻辑导致的：

• 环境变量加载问题：MySQL官方镜像的启动脚本docker-entrypoint.sh会临时设置认证相关的环境变量，但这些变量仅在启动脚本的shell会话中有效。直接执行mysqladmin ping时，健康检查进程跳过了shell初始化流程，无法获取正确的认证参数，导致连接失败，进而触发Swarm的容器重启机制，重启过程中发送了shutdown信号给MySQL。而用sh -c包裹后，shell会重新加载全局环境变量，mysqladmin能正常完成认证和ping检查。
• Swarm的命令解析差异：单机Docker和Swarm对CMD-SHELL的参数传递逻辑有细微区别。直接执行mysqladmin ping时，Swarm可能错误解析参数，导致mysqladmin误执行shutdown操作；通过shell包裹后，命令由shell统一解析，避免了参数传递错误。

可行的解决方式 #

1. 用sh -c包裹健康检查命令，确保在标准shell环境中执行，同时给MySQL留足初始化时间：

   healthcheck:
     test: ["CMD-SHELL", "sh -c 'mysqladmin ping'"]
     interval: 10s
     timeout: 5s
     retries: 3
     start_period: 30s
   

2. 明确指定mysqladmin的认证参数，不依赖环境变量自动加载：

   healthcheck:
     test: ["CMD-SHELL", "sh -c 'mysqladmin ping -u root -p${MYSQL_ROOT_PASSWORD}'"]
     interval: 10s
     timeout: 5s
     retries: 3
   

3. 如果不想用sh -c，可以尝试直接指定完整命令路径并显式传递环境变量：

   healthcheck:
     test: ["CMD", "/usr/bin/mysqladmin", "ping", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
     interval: 10s
     timeout: 5s
     retries: 3
   

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