Web 服务器与网关 / 系统课时
定位常见 4xx 响应
定位常见 4xx 响应
本课解决 Nginx 返回 400、403、404、413、414 和 429 等客户端错误时如何快速定位原因的问题。通过建立从请求入口到治理规则的排查顺序,可以减少盲目修改配置造成的二次故障。
学习目标
- 掌握常见 4xx 状态码对应的排查方向。
- 根据 Nginx 匹配流程定位请求失败位置。
- 使用日志和配置验证修复结果。
建立 4xx 排查顺序
4xx 通常表示请求无法被 Nginx 正常接受或处理。排查时应先确认请求是否进入正确的 server 和 location,再检查文件、请求头、请求体以及访问控制规则。推荐顺序如下:
- 查看 access_log 中的状态码和请求路径。
- 检查
server_name、location和重写规则。 - 检查权限、大小限制和安全策略。
排查匹配与资源问题
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按自己的节奏,确认真正理解。