Docker容器无内置重启次数上限，需用on-failure:N策略限制连续失败重试次数，并配合健康检查和启动守卫脚本实现有效防循环控制。
在 docker 中，容器的“重启计数器限制无效的自动拉起循环”本质上是对 --restart 策略与容器启动失败行为之间误解导致的问题。docker 本身**没有内置的“重启次数上限”机制来终止无限重启循环**（比如 on-failure 不带最大重试次数），但可以通过组合策略、健康检查和外部干预来有效控制。
理解 restart 策略的真实行为
Docker 的 --restart 选项有几种模式，关键点在于：
-
no：从不自动重启（默认） -
always：无论退出码如何，总是重启（可能造成无限拉起循环） -
on-failure[:max-retries]：仅当非零退出码退出时重启；若指定max-retries（如on-failure:3），则最多尝试 3 次后停止，不再自动拉起 -
unless-stopped：等同于always，但跳过已手动docker stop的容器
⚠️ 注意：on-failure 的 max-retries 是**自上次成功运行以来的连续失败计数**，不是全局累计值；且该计数器由 Docker 守护进程维护，重启 Docker daemon 会重置它。
用 on-failure + max-retries 切断无效循环
这是最直接有效的做法——明确限制失败重试次数：
- 启动容器时指定：
docker run --restart on-failure:5 nginx:alpine→ 最多重启 5 次，第 6 次失败后容器状态变为Exited (1)并停止尝试 - 对已有容器，可通过
docker update --restart on-failure:3 container_name动态修改（需容器处于 stopped 状态或支持热更新的 Docker 版本） - 在
docker-compose.yml中写为：restart: "on-failure:3"
（注意引号，避免 YAML 解析为布尔值）
配合健康检查实现更智能的退出控制
单纯依赖退出码可能不够（例如进程卡死但没崩溃）。可添加健康检查，在检测到异常时主动退出，触发 on-failure 逻辑：
- 示例：一个 Python Web 应用，启动后需连接数据库，若 30 秒内连不上就应放弃
- 在镜像中编写健康脚本
/health.sh，检查关键依赖是否就绪，失败时exit 1 - Dockerfile 中声明：
HEALTHCHECK --interval=10s --timeout=3s --start-period=30s --retries=3 CMD ["/health.sh"]
- 搭配
--restart on-failure:2：健康检查连续失败 3 次 × 重启 2 次 = 最多约 1 分钟后彻底停止
用 init 进程或 wrapper 脚本做启动守卫
对于易崩溃的旧应用，可在容器内加一层控制逻辑：
- 使用
tini（Docker 官方推荐 init）处理僵尸进程，避免信号传递异常导致假死 - 自定义启动脚本，记录启动时间戳和失败次数（存入
/tmp或内存文件系统），超过阈值则exit 1而非反复 exec - 示例片段：
#!/bin/sh ATTEMPTS=$(cat /tmp/start_count 2>/dev/null || echo 0) if [ "$ATTEMPTS" -ge 3 ]; then echo "Too many start failures, bailing out." >&2 exit 1 fi echo $((ATTEMPTS + 1)) > /tmp/start_count exec "$@"
不复杂但容易忽略：Docker 的重启机制是守护进程级的简单逻辑，真正的“防循环”要靠策略选对（on-failure:N）、依赖可控（健康检查）、启动可审计（wrapper 脚本）三者结合。
