Web 服务器与网关 / 系统课时
模拟 404 和 502 故障排查
模拟 404 和 502 故障排查
把路径错误和上游不可连接分别制造出来,能够练习按证据定位,而不是看到错误就重启。本篇仅在回环实验中请求缺失脚本,再依次停止一个和全部后端,区分静态文件问题、可用成员切换与整个代理组不可用。
学习目标
- 从状态、路径和 error log 区分 404 与 502。
- 验证单实例停止不一定导致用户请求失败。
- 在恢复后核对失败窗口与关键响应。
在独立配置中限制故障范围
沿用本章静态目录与 backend.py 的 A、B 实例,需空闲回环 8080、9001、9002。只操作这些明确属于实验的进程,不停止生产服务。先创建 /tmp/nginx-entry-fault 并给予实验 Worker 写日志权限,以下片段示例放在 http:
upstream fault_api {
server 127.0.0.1:9001 max_fails=1 fail_timeout=2s;
server 127.0.0.1:9002 max_fails=1 fail_timeout=2s;
}
server {
listen 127.0.0.1:8080;
server_name app.test;
root /tmp/nginx-web-entry;
error_log /tmp/nginx-entry-fault/error.log warn;
location /assets/ { try_files $uri =404; }
location /api/ {
proxy_connect_timeout 1s;
proxy_read_timeout 3s;
proxy_pass http://fault_api;
}
location / { return 404; }
}为保留缺失文件的直接 open 错误证据,实际诊断时还可以查看静态处理路径;try_files 返回的 404 本身未必产生文件打开失败日志。访问日志、实际映射路径与文件检查同样是证据。
先验证缺失资源与正常 API
检查并重载后执行完整命令:
curl --noproxy '*' --resolve app.test:8080:127.0.0.1 -sS -o /dev/null -w 'asset=%{http_code}\n' http://app.test:8080/assets/missing.js
curl --noproxy '*' --resolve app.test:8080:127.0.0.1 -sS http://app.test:8080/api/health预期结果:asset=404,随后 A /api/health 或 B /api/health。检查缺失文件在 root 拼接的实际路径,并确认请求没有落到 SPA 回退;不能因为首页正常就认定脚本存在。

再逐步停止后端
只在 A 实验终端按 Ctrl+C,连续请求 /api/health,应仍可能由 B 成功返回;一次失败尝试可能被安全 GET 的重试吸收。然后在 B 实验终端也按 Ctrl+C,再执行:
curl --noproxy '*' --resolve app.test:8080:127.0.0.1 -sS -o /dev/null -w 'api=%{http_code}\n' http://app.test:8080/api/health
tail -n 8 /tmp/nginx-entry-fault/error.log预期结果:api=502;日志可能包含连接被拒绝或没有可用上游,具体目标端口、时间和重试情况不同。配置语法仍可能通过,说明语法检查不覆盖后端存活。
恢复并完成证据闭环
用原命令重新启动 A、B,等待实验失败窗口两秒过去后再次请求并观察成功。被动失败状态不是持续主动探测,恢复时机取决于新请求、窗口与选择策略,不能保证进程启动后立即所有请求都成功。
| 现象 | 优先核对 |
|---|---|
| 资源 404 | 实际站点、映射路径、构建版本 |
| 上游连接被拒绝 | 实例监听、地址端口、网络空间 |
| 无可用上游 | 全体成员和被动失败状态 |
| 后端合法返回 500 | 应用错误与请求证据 |
不要把后端合法 500 改写成“网络 502”,也不要通过关闭所有检查掩盖故障。记录每一步状态、日志和恢复结果,实验结束关闭专用 Nginx 与后端,保留配置供复盘。