HTTP 状态码完整参考表

实战片段

要点：① 按首位数字五分（1xx 信息 / 2xx 成功 / 3xx 重定向 / 4xx 客户端错 / 5xx 服务端错）能解决 80% 的判断；② 502 与 504 的区别是「谁的问题」而非严重程度 —— 502 是网关拿到无效响应（查上游是否在跑、端口是否监听），504 是等待超时（查上游性能、慢查询、连接池）；③ 302 会把 POST 改成 GET 导致 body 丢失，需要保方法用 307/308；④ 限流返回 429 + Retry-After，维护窗口返回 503 + Retry-After，混淆会让客户端立即重试加剧过载。

// ① 按首位数字分类
function statusClass(code) {
  if (code < 200) return 'info'
  if (code < 300) return 'success'
  if (code < 400) return 'redirect'
  if (code < 500) return 'client-error'
  if (code < 600) return 'server-error'
  return 'unknown'
}

// ② 502 与 504：排查方向完全不同
function diagnoseGatewayError(code, ctx) {
  if (code === 502) {
    // 收到了无效响应 ⇒ 上游有问题
    return [
      '上游进程是否在跑：systemctl status / docker ps',
      '端口是否监听：ss -tlnp | grep ' + ctx.port,
      '负载均衡后端健康检查是否通过',
    ]
  }
  if (code === 504) {
    // 等待超时 ⇒ 上游慢或卡住
    return [
      '上游响应时间：curl -w "%{time_total}" ' + ctx.url,
      '是否有慢查询或锁等待',
      '连接池是否耗尽（DB / HTTP client）',
    ]
  }
  return ['先看响应体与响应头，状态码只说明大类']
}

// ③ 302 会把 POST 改成 GET ⇒ 需要保方法用 307/308
// ❌ res.redirect(302, '/target')   浏览器可能把 POST 变 GET，body 丢失
// ✅ res.redirect(307, '/target')   临时重定向，保持方法与 body
// ✅ res.redirect(308, '/target')   永久重定向，保持方法
// 反过来：确实想把 POST 转 GET ⇒ 用 302 或 303（303 明确要求 GET）

// ④ 限流用 429，维护/过载用 503，都带 Retry-After
function rateLimited(retryAfterSec) {
  return { status: 429, headers: { 'Retry-After': String(retryAfterSec) } }
}
function unavailable(retryAfterSec) {
  return { status: 503, headers: { 'Retry-After': String(retryAfterSec) } }
}
console.log(statusClass(404), statusClass(502), statusClass(429))