必须为ThinkPHP添加/health接口并配置Nginx健康检查：一、新增Health控制器返回200 OK；二、启用nginx_upstream_check_module主动探测；三、用max_fails+proxy_next_upstream实现被动检查；四、OpenResty中用Lua共享字典做熔断。
如果您在使用 Nginx 作为反向代理接入 ThinkPHP 应用时，需实时掌握其后端服务是否可响应、是否处于存活状态，则必须依赖 Nginx 对上游服务的健康检查能力。ThinkPHP 本身不提供标准健康端点，需配合定制化配置或轻量接口实现有效探测。以下是多种可行的监控与检测方法：
一、为ThinkPHP添加专用健康检查接口
该方法通过在 ThinkPHP 应用中暴露一个低开销、无业务逻辑的 HTTP 接口（如 /health），供 Nginx 主动探测，确保返回明确的状态码以判定服务活性。
1、在 ThinkPHP 的 app/controller 目录下新建 Health.php 控制器文件。
2、在该文件中定义 index 方法，仅返回 HTTP 状态码 200 及纯文本 OK，不加载模型、不查询数据库、不触发中间件业务逻辑。
立即学习“PHP免费学习笔记（深入）”；
3、确保路由配置允许未登录用户直接访问该路径，例如在 route/app.php 中添加：Route::get('health', 'Health/index');
4、启动服务后，手动访问 http://your-domain.com/health，确认返回内容为 OK 且响应头中 Status: 200。
二、配置Nginx主动健康检查（需支持 nginx_upstream_check_module）
此方案要求 Nginx 已编译并启用第三方模块 nginx_upstream_check_module（常见于 OpenResty 或 Tengine），可实现周期性 HTTP 探测，精准识别 ThinkPHP 进程是否存活且能响应请求。
1、在 http 块中定义 upstream，并启用 check 指令：
2、设置探测间隔为 5 秒，连续 2 次成功标记为可用，连续 3 次失败标记为不可用：
3、发送 HEAD 请求至 /health 路径，避免产生冗余响应体：
4、指定只接受 HTTP 2xx 和 3xx 状态码视为健康响应：
5、完整配置示例片段如下：check interval=5 rise=2 fall=3 timeout=1 type=http;
6、确保后端 ThinkPHP 服务器已部署上一步所建的 /health 接口，否则所有探测将失败并持续剔除节点。
三、使用Nginx原生被动健康检查（无需额外模块）
该方式基于 Nginx 自带的 ngx_http_upstream_module，不依赖外部模块，通过请求失败行为自动隔离异常节点，适用于无法定制 Nginx 编译环境的场景。
1、在 upstream 定义中为每个 ThinkPHP 后端显式配置 max_fails 和 fail_timeout 参数。
2、将 max_fails 设为 3，表示连续 3 次转发失败即触发隔离。
3、将 fail_timeout 设为 30s，表示该节点将在 30 秒内不再接收新请求。
4、在 location 块中启用 proxy_next_upstream，指定哪些错误条件触发重试与切换：
5、推荐配置值为：proxy_next_upstream error timeout http_500 http_502 http_503 http_504;
6、注意：该机制无法提前发现僵死进程（如 PHP-FPM 卡住但端口仍监听），仅在真实请求失败后才响应。
四、通过Lua脚本实现细粒度熔断与状态标记（OpenResty环境）
当需对 ThinkPHP 服务实施失败率阈值控制、动态熔断或跨请求上下文的状态聚合时，可利用 OpenResty 的共享字典（shared dict）在内存中维护各后端节点的失败计数与时间戳，实现轻量级应用层健康决策。
1、在 init_by_lua_block 中声明名为 health_status 的 shared dict，最大容量设为 10000。
2、在 access_by_lua_block 中读取当前 upstream server 的 IP 和端口。
3、从 shared dict 查询该节点过去 60 秒内的失败次数及最近失败时间。
4、若失败率超过 70% 且失败总数 ≥ 5，则跳过该节点，改用备用 upstream 或返回降级响应。
5、每次请求结束后，根据 proxy_status 结果（如 502/504）异步更新 shared dict 中对应节点的失败计数。
6、该逻辑需配合 ThinkPHP 的 /health 接口调用链路，确保探测请求本身也被纳入统计范畴。
