Nginx日志中错误代码解读

Nginx日志中的错误代码，是排查故障时最直接的线索。它们就像服务器在跟你“说话”，告诉你哪里出了问题。下面整理了日常运维中常见的Nginx错误代码及其含义，建议收藏备用。

先从客户端常见的“请求畸形”类说起：

400 Bad Request：看起来客户端那边发来的请求格式不太对劲，服务器这边直接懵了，不知道该怎么处理。原因通常是URL拼写有问题或者请求头字段格式乱了。

401 Unauthorized：这基本是在说：“嘿，你需要先证明你是谁！”客户端没有提供有效的身份验证凭证，或者提供的凭证不对。

402 Payment Required：这个错误码虽然存在，但实际应用中极少见到。它原本是为“需要付费才能访问”的场景预留的，目前基本是个理论上的概念。

403 Forbidden：权限不够，禁止访问。服务器明确知道你要什么，但就是不给你——要么是目录权限设置不对，要么是IP被拉黑了。

404 Not Found：这大概是最常见的一个了，服务器翻遍了所有角落，也没找到你请求的资源。可能是文件被删了、路径写错了，或者链接本身就是个死链。

405 Method Not Allowed：你用的HTTP方法（比如GET、POST）不被允许。举个例子，有些接口只能接受POST请求，你偏偏用了GET，那它就会甩给你这个错误。

406 Not Acceptable：服务器无法生成客户端Accept头部指定的响应格式。比如客户端要求返回JSON，但服务器只能返回XML，双方谈不拢。

407 Proxy Authentication Required：需要先通过代理服务器的身份验证才能继续，通常和代理配置有关。

408 Request Timeout：客户端太磨蹭，在服务器等它发完请求的过程中超时了。要么是网络慢，要么是客户端没及时响应。

409 Conflict：请求与服务器当前状态产生了冲突。比如试图创建一个已经存在的资源，或者更新一个已经被别人改过的版本。

410 Gone：资源已经永久删除了，服务器建议客户端更新缓存、别再往这条死路上走了。

411 Length Required：服务器要求客户端在请求头中带上Content-Length，但客户端没给。这在处理POST或PUT请求时比较常见。

412 Precondition Failed：客户端在请求头里设置了一些前提条件（比如If-Match），但服务器检查后发现不满足，直接拒绝处理。

413 Payload Too Large：客户端上传的请求体太大，服务器表示“我装不下”。常见于文件上传场景，通常调大client_max_body_size就能解决。

414 URI Too Long：请求的URL太长，服务器连读都读不完。一般是因为GET请求带了一大堆参数，或者URL本身被意外拼接了很长的字符串。

415 Unsupported Media Type：客户端发送的请求体格式服务器不认识。通常是上传文件时MIME类型不对，比如上传了图片但声明了文本格式。

416 Range Not Satisfiable：客户端请求的资源范围（比如断点续传时的分片）无效，服务器无法满足。

417 Expectation Failed：客户端在请求头中设置了Expect字段，但服务器无法满足这个期望。

418 I'm a teapot：这个比较有意思，它其实是个复活节彩蛋，字面意思是“我是茶壶”，服务器在告诉你它拒绝给你泡咖啡。严肃场合不会出现，但看到了也不必慌张。

421 Misdirected Request：请求被发到了错误的服务器上，客户端应该换一个URI或协议重试。

422 Unprocessable Entity：请求体的格式虽然正确，但服务器无法处理其中的内容。比如语义上不符合业务规则，数据校验不通过。

423 Locked：资源被锁定，暂时无法操作。客户端可以稍后再试。

424 Failed Dependency：当前请求的依赖项出了问题，比如上游服务器不可用，导致请求无法完成。

425 Too Early：客户端在服务器还没准备好之前就发了请求，通常与HTTP/3的早期数据有关。

426 Upgrade Required：服务器要求客户端升级到其他协议版本（比如从HTTP/1.1升级到HTTP/2），否则无法继续通信。

428 Precondition Required：服务器要求客户端在请求中带上某些前提条件，比如条件请求头，但客户端没带。

429 Too Many Requests：请求太频繁了，超过了服务器的速率限制。这时候客户端需要放慢速度，或者等一段时间再试。

431 Request Header Fields Too Large：请求头太大了，服务器处理不了。可能是Cookie塞了太多东西，或者某个头字段膨胀了。

451 Unavailable For Legal Reasons：服务器因法律原因无法提供请求的资源。比如内容被当地法规屏蔽，或者涉及版权纠纷。

总的来说，这些错误代码是排查问题的第一手线索，能帮我们快速定位方向，然后采取针对性的修复措施。当然，Nginx日志中出现的错误码远不止这些，具体还会因配置和应用场景有所不同。但掌握上面这些，日常运维中90%的问题都能找到对应的解决思路了。