如何调整Docker HEALTHCHECK配置 兼顾快速启动与低频率健康检查

你可以通过Docker原生参数或者自定义脚本两种方式实现需求：

方案一：Docker 25+ 原生参数实现（推荐） #

Docker 25及以上版本新增了--start-interval参数，专门用于区分启动阶段和运行阶段的健康检查间隔：容器未进入健康状态时，使用--start-interval指定的间隔执行检查；容器标记为健康后，自动切换为--interval指定的常规间隔。

修改后的配置如下：

HEALTHCHECK --interval=300s \
            --timeout=5s \
            --start-period=20s \
            --start-interval=10s \
            --retries=2 \
            CMD curl http://localhost:<port> > /dev/null || exit 1

参数说明：

• --start-interval=10s：启动阶段每隔10秒执行一次检查，首次检查会在容器启动10秒后触发，符合你快速验证启动状态的需求
• --start-period=20s：启动宽限期，该时间段内的检查失败不会计入重试次数，可根据应用实际最长启动时间调整
• --retries=2：启动阶段最多允许2次检查失败，只要应用正常启动就会立刻标记为健康，完成启动流程
• --interval=300s：容器进入健康状态后，自动切换为300秒一次的常规检查，不会占用过多系统资源

方案二：低版本Docker兼容实现 #

如果你的Docker版本低于25，不支持--start-interval参数，可以通过自定义健康检查脚本实现相同逻辑：

1. 新建健康检查脚本healthcheck.sh：

#!/bin/sh
START_TIME=$(stat -c %Y /proc/1)
CURRENT_TIME=$(date +%s)
ELAPSED=$((CURRENT_TIME - START_TIME))
LAST_CHECK_FILE=/tmp/last_healthcheck

# 启动前60秒为快速检测阶段
if [ $ELAPSED -lt 60 ]; then
    curl -f http://localhost:<port> > /dev/null 2>&1 || exit 1
else
    # 运行阶段控制检查间隔为300秒
    if [ -f $LAST_CHECK_FILE ]; then
        LAST_CHECK=$(cat $LAST_CHECK_FILE)
        [ $((CURRENT_TIME - LAST_CHECK)) -lt 300 ] && exit 0
    fi
    if curl -f http://localhost:<port> > /dev/null 2>&1; then
        echo $CURRENT_TIME > $LAST_CHECK_FILE
        exit 0
    else
        exit 1
    fi
fi

2. 修改Dockerfile配置：

COPY healthcheck.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/healthcheck.sh
HEALTHCHECK --interval=10s --timeout=5s --start-period=5s --retries=6 CMD /usr/local/bin/healthcheck.sh

该方案将固定检查间隔设为10秒，由脚本内部判断执行阶段：启动前60秒正常执行检查，运行阶段未到300秒间隔直接返回成功，等效于常规阶段300秒一次检查，兼顾启动速度和资源占用要求。

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