如何通过Nginx Upstream-Check机制实现后端故障节点自动安全下线？

本文共计949个文字，预计阅读时间需要4分钟。

Nginx官方版本默认不包含`upstream_check_module`，直接写入`check`指令会报错，错误信息为unknown directive。

验证是否就绪：运行 nginx -V 2>&1 | grep -o check，有输出才表示模块存在；或者尝试启动时看错误日志是否报 unknown directive。

• 线上环境别依赖包管理器“猜”模块，nginx -V 和 nginx -t 是唯二可信依据
• OpenResty 用户需确认未禁用该模块（部分精简版会裁掉）
• Docker 场景下，基础镜像如 nginx:alpine 绝对不含此模块，必须自建镜像

check 指令必须紧贴 upstream 块内，且不能与 proxy_pass 混用在 server 块里

check 是 upstream 上下文指令，写在 server 或 location 里会直接语法错误。常见误写是把健康检查逻辑当成 location 策略来配，结果 Nginx 启动失败。