Nginx全局自愈配置核心是“内置韧性”：通过proxy_intercept_errors + error_page实现毫秒级网关自愈，/healthz纯指令心跳探活，proxy_next_upstream主动故障转移，并集成请求ID、超时控制与安全加固，不依赖外部系统即可应对进程崩溃、上游失联等常见故障。
构建具备自愈能力的 Nginx 全局配置，关键不是堆砌功能，而是让配置本身能应对常见故障——进程崩溃、上游失联、健康检查失败、配置误改等，并在不依赖外部系统的情况下快速恢复服务。以下是一个精简、可落地、带自愈逻辑的全局模板骨架，已融合 internal + error_page 网关层自愈、/healthz 探活接口、proxy_intercept_errors 主动拦截、以及基础安全与可观测性设计。
一、核心自愈机制：用 internal + error_page 终结错误链
这是最轻量、最可靠的网关级自愈手段，无需后端、不走网络、毫秒级响应：
- 在
http或server块中启用错误拦截：proxy_intercept_errors on; - 定义标准错误跳转（含等号确保状态码透出）：
error_page 500 502 503 504 = /_err5xx; - 声明内部处理 location，禁止外部直访：
location = /_err5xx { internal; add_header Content-Type "application/json; charset=utf-8"; return 502 '{"code":502,"msg":"Upstream unavailable","rid":"'$request_id'"}'; } - 如需透传后端错误线索，确保 upstream 返回了
X-Backend-Error，并在该 location 中加：add_header X-Backend-Error $upstream_http_x_backend_error;
二、暴露健康检查端点：/healthz 是自愈系统的“心跳线”
所有监控、Keepalived、K8s livenessProbe 都依赖它，必须独立、稳定、无副作用：
- 在 server 块内添加显式 healthz 接口：
location = /healthz { access_log off; log_not_found off; return 200 "OK\n"; } - 避免使用
stub_status作为健康依据——它依赖 worker 进程，而进程挂掉时该接口本身不可用；/healthz是纯 Nginx 指令返回，只要主进程活着就一定可用 - 若需更深度检查（如验证 upstream 连通性），可用
ngx_http_healthcheck_module或 Lua 脚本，但非必需；简单 return 已满足 95% 场景
三、防御性代理配置：降低故障传播概率
让 Nginx 在上游异常时主动“断连”，而不是卡住或透传错误：
- 设置合理超时，防止连接堆积：
proxy_connect_timeout 5s;<br>proxy_send_timeout 30s;<br>proxy_read_timeout 30s;
- 启用重试与备用节点（如有多台 upstream）：
proxy_next_upstream error timeout http_502;<br>proxy_next_upstream_tries 3;<br>proxy_next_upstream_timeout 10s;
- 关闭不必要的 header 透传，减少信息泄露：
proxy_hide_header X-Powered-By;<br>proxy_hide_header Server;
四、基础加固与可观测支撑
自愈的前提是能快速定位问题，配置需自带诊断能力：
- 开启请求 ID 注入，串联日志与 trace：
map $request_id $req_id { "" $request_id; }<br>log_format main '$req_id $remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent"'; - 限制请求头/体大小，防 DoS 类攻击导致进程僵死：
client_header_timeout 15s;<br>client_body_timeout 15s;<br>client_max_body_size 50m;
- 禁用危险指令（如未授权的 rewrite 或 eval），避免配置被注入后执行任意逻辑
这个模板不追求大而全，而是聚焦“故障发生时 Nginx 自身还能做什么”。它不依赖 Prometheus、Zabbix 或作业平台——那些是上层编排，而这里是底座韧性。真正可靠的自愈，始于配置本身的健壮性与可预测性。
