Web 服务器与网关 / 系统课时

定位常见 4xx 响应

定位常见 4xx 响应

本课解决 Nginx 返回 400、403、404、413、414 和 429 等客户端错误时如何快速定位原因的问题。通过建立从请求入口到治理规则的排查顺序,可以减少盲目修改配置造成的二次故障。

学习目标

  • 掌握常见 4xx 状态码对应的排查方向。
  • 根据 Nginx 匹配流程定位请求失败位置。
  • 使用日志和配置验证修复结果。

建立 4xx 排查顺序

4xx 通常表示请求无法被 Nginx 正常接受或处理。排查时应先确认请求是否进入正确的 server 和 location,再检查文件、请求头、请求体以及访问控制规则。推荐顺序如下:

  1. 查看 access_log 中的状态码和请求路径。
  2. 检查 server_name、location 和重写规则。
  3. 检查权限、大小限制和安全策略。

排查匹配与资源问题

404 常见原因是 root 路径错误、文件不存在或 location 匹配到了错误位置。403 常见原因包括文件权限不足、目录索引关闭或访问规则拒绝。

nginx
server {
    listen <PORT>;
    server_name example.com;

    location /app/ {
        root /data/www;
        index index.html;
    }
}

预期结果

text
访问 /app/index.html
Nginx 查找 /data/www/app/index.html
文件存在时返回 200
不存在时返回 404

如果返回 403,应继续检查文件权限:

bash
ls -ld /data/www/app

预期输出

text
drwxr-xr-x 2 nginx nginx <TIME> app

排查请求格式与大小限制

400 通常与请求格式异常有关,例如非法请求行、错误 Header 或协议格式问题。413 表示请求体超过限制,需要检查 client_max_body_size。

414 表示请求 URI 过长,常见于错误拼接的大量查询参数。

nginx
http {
    # 根据业务上传需求调整,避免无限制接收大文件
    client_max_body_size 20m;
}

预期结果

text
小于或等于 20MB 的请求正常进入处理流程
超过限制的上传请求返回 413

排查访问控制与限流规则

429 通常由限速模块或网关治理策略触发。定位时需要检查 limit_req、limit_conn 以及上游网关策略是否同时生效。

nginx
http {
    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;

    server {
        location /api/ {
            limit_req zone=api_limit burst=20 nodelay;
        }
    }
}

预期结果

text
正常访问速率请求返回业务响应
超过限制的请求返回 429

验证修复结果

修改配置后先执行语法检查,再平滑加载配置。不要直接重启服务,否则可能扩大生产影响范围。

bash
nginx -t && nginx -s reload

预期输出

text
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位常见 4xx 响应

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通