Axis笔记

外观

3.1 常见错误码速查

约 460 字

排查错误码

本页对应「三、操作步骤」的 3.1，完成常见错误码速查。返回上级：故障排查操作手册。

前置条件

  • 故障可复现，或已有监控告警的明确时间点。
  • 可访问 Nginx 日志与后端服务，能执行 systemctl 与 curl。
  • 已记录故障开始时间与受影响页面。

操作步骤

  1. 先取响应头与状态码，确定故障发生在哪一层。
curl -sSI https://example.com/ | head -n 12
curl -sS -o /dev/null -w 'code=%{http_code} connect=%{time_connect} total=%{time_total}\n' https://example.com/

  1. 按错误码对照处理方向：502 为 Nginx 连不上后端，503 为后端拒绝或限流，504 为后端超时，403 为权限或 WAF 拦截，404 为路径或产物缺失。

  2. 确认后端端口与进程状态。

ss -lntp | grep 3000
systemctl status axis-api --no-pager
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3000/healthz
  1. 提取 Nginx 上游错误明细。
sudo grep -E 'upstream|connect\(\) failed|timed out' /var/log/nginx/example.error.log | tail -n 20
  1. 用 Host 头绕过 DNS 与 CDN 直连源站复测。
curl -sSI -H 'Host: example.com' http://203.0.113.10/ | head -n 5
curl -sS -o /dev/null -w '%{http_code}\n' -H 'Host: example.com' http://203.0.113.10/

结果确认

  • 能明确说出故障发生在 Nginx、应用还是数据库层。
  • 错误码与日志中的上游地址、端口一致。
  • 直连源站可复现同一现象，排除 CDN 干扰。
  • 已记录首次出现时间与受影响页面数量。

注意事项

  • 5xx 与 4xx 的处理方向相反，不要一看到错误就重启服务。
  • 缓存可能掩盖故障，验证时加 -H 'Cache-Control: no-cache'。
  • 记录每次 curl 的时间与结果，作为后续时间线的证据。
  • 403 与 502 同时出现时，先处理 502，权限问题通常是次生现象。