MySQL 8.0 容器健康检查不能只用 mysqladmin ping，因其默认走 socket 连接（/var/run/mysqld/mysqld.sock），而健康检查进程常以非 root 用户运行且未挂载该路径，导致连接失败；必须显式指定 TCP 连接（--host=127.0.0.1 --port=3306）、认证参数及最小权限账号，并优先使用 mysql -e "SELECT 1" 替代 mysqladmin，配合 HEALTHCHECK exec 形式与正确转义的环境变量注入密码。
MySQL 8.0 容器健康检查为什么不能只用 mysqladmin ping
因为 mysqladmin ping 默认走 socket 连接（/var/run/mysqld/mysqld.sock），而容器健康检查通常以非 root 用户、无挂载 socket 路径的普通进程运行，直接执行会报错 mysqladmin: connect to server at 'localhost' failed 或 Can't connect to local MySQL server through socket。必须显式指定 TCP 连接 + 认证参数，且账号需具备最小权限（CONNECTION_ADMIN 或至少 SELECT on performance_schema）。
Docker HEALTHCHECK 指令的正确写法
避免使用 shell 形式（HEALTHCHECK CMD ...）导致 exit code 误判；改用 exec 形式，确保信号和退出码直传。关键点：
-
HEALTHCHECK --interval=30s --timeout=5s --start-period=60s --retries=3：启动后宽限 60 秒再开始检查，避免 MySQL 还没完成初始化就失败 - 命令必须用
mysqlCLI 而非mysqladmin，因后者在 MySQL 8.0+ 对密码策略更敏感，且不支持--connect-timeout - 必须指定
--host=127.0.0.1（强制走 TCP）、--port=3306、--user、--password，且密码不能明文写死——应通过MYSQL_ROOT_PASSWORD环境变量或配置文件注入 - 推荐检查语句：
SELECT 1，比SHOW STATUS LIKE 'Uptime'更轻量、更可靠
示例（Dockerfile 片段）：
HEALTHCHECK --interval=30s --timeout=5s --start-period=60s --retries=3 \ CMD mysql --host=127.0.0.1 --port=3306 --user=root --password="$MYSQL_ROOT_PASSWORD" -e "SELECT 1" > /dev/null 2>&1
使用 docker-compose.yml 时的等效配置
如果不用 Dockerfile 构建，而在 docker-compose.yml 中声明健康检查，注意环境变量展开仅在容器运行时生效，所以 $MYSQL_ROOT_PASSWORD 必须由 compose 环境或 secrets 注入，不能写成字面量。常见错误是把密码硬编码进 command 字符串里，导致镜像不可复用。
正确写法（依赖 .env 文件或 secrets）：
services:
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
healthcheck:
test: ["CMD-SHELL", "mysql --host=127.0.0.1 --port=3306 --user=root --password=$${MYSQL_ROOT_PASSWORD} -e 'SELECT 1' >/dev/null 2>&1"]
interval: 30s
timeout: 5s
start_period: 60s
retries: 3
注意：$$ 是 YAML 转义，确保 compose 将 $MYSQL_ROOT_PASSWORD 作为变量传递给容器内 shell；若用 secrets，需改用 mysql --defaults-extra-file=/run/secrets/mysql_root_password 并挂载 secret 文件。
健康检查失败时的真实表现与调试方法
容器状态不会立刻退出，而是标记为 unhealthy；Kubernetes 会据此触发重启或剔除流量，但 Docker Desktop 或 docker ps 只显示状态，不自动干预。容易忽略的坑：
- MySQL 8.0 默认启用
caching_sha2_password插件，而旧版mysql客户端（如 Alpine 的 mariadb-client）可能不兼容，报错Plugin caching_sha2_password could not be loaded—— 解决方案是换用官方 MySQL 客户端镜像，或在启动参数加--default-authentication-plugin=mysql_native_password - 健康检查命令中未设置
--connect-timeout=3，当 MySQL 正在刷盘或锁表时，CLI 会卡满 timeout 时间再失败，拖慢整体探测节奏 - root 用户被禁用远程登录（默认行为），但健康检查走的是本地 TCP，不受
bind-address限制 —— 唯一要求是skip-networking不能开启（该选项会彻底关闭 TCP 监听）
调试建议：进容器手动运行健康检查命令，加 -v 参数看详细错误；同时查 docker logs mysql 是否有 mysqld 启动失败或权限拒绝记录。
