Docker HEALTHCHECK基于grep的命令为何无法正常生效？

你的HEALTHCHECK命令失效的核心原因是用了Docker CMD的exec数组格式，但命令中包含shell专属语法，导致Docker无法正确解析执行。

具体问题分析 #

Docker的CMD [ ... ]数组格式会直接调用指定的命令，不会启动shell来解析其中的命令替换$(...)、比较运算符==、逻辑符号||等语法。这就意味着你写的整个表达式会被当作一个命令的参数去执行，而不是被shell解析成逻辑判断，自然无法返回正确的0状态码，容器也就一直停留在health: starting。

而你进入容器后是在shell环境下执行这个命令，shell会处理这些语法，所以能正常返回0。

解决方法 #

把HEALTHCHECK的CMD改成shell格式（不用数组，直接写命令字符串），让Docker自动启动/bin/sh来解析执行你的逻辑：

修改后的Dockerfile示例：

FROM ubuntu:latest

# 改用shell格式CMD，让shell处理命令替换与逻辑判断
HEALTHCHECK --start-period=30s --interval=30s --timeout=4s --retries=1000 CMD if [ "$(ps -ax | grep -i "sleep infinity" | grep -v grep | wc -l)" == 2 ]; then exit 0; else exit 1; fi

CMD echo "Hello, we're done with what we're supposed to do" && sleep infinity

或者可以简化逻辑，直接用grep的静默模式判断进程是否存在，更简洁高效：

HEALTHCHECK --start-period=30s --interval=30s --timeout=4s --retries=1000 CMD ps ax | grep -i "sleep infinity" | grep -v grep > /dev/null || exit 1

这样修改后，Docker会通过shell解析你的健康检查命令，当sleep infinity进程存在时返回0，容器状态就会切换为healthy。

内容的提问来源于stack exchange，提问作者The Quantum Physicist