您现在的位置: 365建站网 > 365文章 > 405 Method Not Allowed 怎么排查?先分清 Allow 头、TRACE 与限流规则三种成因

405 Method Not Allowed 怎么排查?先分清 Allow 头、TRACE 与限流规则三种成因

文章来源:365jz.com 点击数:365 更新时间:2024-08-23 09:05

一、先看清楚:405 不是「页面不存在」,是「动词不对」

很多人把 405 当成 404 来查,方向一开始就错了。MDN 对 405 Method Not Allowed 的原文定义只有一句话:

The HTTP 405 Method Not Allowed client error response status code indicates
that the server knows the request method, but the target resource doesn't
support this method.

关键词是 knows。服务器完全认识你用的这个动词(GET、POST、PUT、DELETE、TRACE……),也找到了这个 URL 对应的资源,只是这个资源不允许用这个动词访问。所以路径、Rewrite、DNS、证书这些方向统统可以排除,真正要查的是「请求方法」和「这个 URL 允许哪些方法」这一件事。

同一条规范里还有两个必须注意的硬性要求:

The server must generate an Allow header in a 405 response with a list of
methods that the target resource currently supports.

Improper server-side permissions set on files or directories may cause a
405 response when the request would otherwise be expected to succeed.

翻译成人话:合法的 405 响应必须带 Allow 头,里面列出该资源当前支持的方法;另外,文件/目录的服务器端权限设置不当,也会造出 405,哪怕其它一切配置都是对的。第二点是最常被漏掉的,尤其在把 PHP 上传、WebDAV 或静态目录挂在权限受限的目录上时。

405 Method Not Allowed 排查示意图
排查 405 的顺序:先看 Allow 头,再看方法限制规则,最后看文件系统权限

二、第一步永远是抓 Allow 头

MDN 对 Allow 响应头的说明如下:

The HTTP Allow response header lists the set of request methods supported
by a resource. This header must be sent if the server responds with a 405
Method Not Allowed status code to indicate which request methods can be
used instead. An empty Allow value indicates that the resource allows no
request methods, which might occur temporarily for a given resource.

所以拿到 405 后,不要猜,直接用命令把响应头打出来:

curl -i -X POST https://example.com/api/order
curl -i -X OPTIONS https://example.com/api/order

一个规范的服务端响应应该长这样:

HTTP/1.1 405 Method Not Allowed
Content-Length: 0
Allow: GET, POST, HEAD

读 Allow 有两种典型结论:

  • Allow 里有你以为支持的动词(例如列表里有 PUT,你发的也是 PUT 却仍 405):说明限制不在这一层,往下查反向代理、CDN、WAF 把方法改写了,或者查同一 URL 被多条 location / Directory 规则命中。
  • Allow 为空:MDN 明确说了「空值表示该资源不允许任何请求方法」,并且「可能是暂时出现的」。常见于维护开关、发布窗口里脚本被摘掉、或者接口鉴权阶段提前返回。这时先复现第二次请求确认是否瞬态,再去代码里找提前 return 的分支。

另外一个实用技巧:用 OPTIONS 主动探测。OPTIONS 的语义就是「问这个 URL 支持什么方法」,如果 OPTIONS 本身返回 200/204 并带 Allow,就直接拿到了答案;如果 OPTIONS 也 405,说明服务端连方法发现都没实现,只能进配置文件里查。

三、第三种成因:TRACE 被禁,这是设计如此,不是故障

405 里有一类非常特殊、也最容易被误报成「网站被人攻击」的情况:用 TRACE 方法请求根地址,返回 405。MDN 在这一页给了完整的原始报文样例:

TRACE / HTTP/1.1
Host: example.com

HTTP/1.1 405 Method Not Allowed
Content-Length: 0
Date: Fri, 28 Jun 2024 14:30:31 GMT
Server: ECLF (nyd/D179)
Allow: GET, POST, HEAD

并配了一句解释:

Server owners often disallow the use of the TRACE method due to security
concerns.

这是因为 TRACE 会把请求内容原样回显,容易被用来做跨站追踪(XST)。所以看到 TRACE 返回 405,结论应该是「安全配置正常」,而不是去修复它。大量扫描器、监控探针、部分老旧客户端会默认发 TRACE,这类告警应当忽略或加入白名单。Apache 侧对应的开关是 core 模块的 TraceEnable(指令清单里可直接查到),nginx 则默认不接受 TRACE。

四、配置层的三类常见「自己把自己锁了」

1. nginx 的 limit_except 写法

nginx 官方 core 模块文档在示例后专门加了一句提醒,原文如下:

Please note that this will limit access to all methods except GET and HEAD.

也就是说 limit_except 的语义是「除了列出来的这些方法之外,其余方法都套用这个 block 里的规则」,是反向选择。想只放行 GET/HEAD 却写成只列 GET,就会把 HEAD 一起限掉;想让 POST 通过却没写进去,POST 就会被限。改完一定要用 curl -i -X POST 复测,不要只看 nginx -t 通过。

2. Apache 的 <Limit> / <LimitExcept>

Apache 指令索引里 AllowMethods、<Limit>、<LimitExcept>、TraceEnable 是四个独立入口,作用域和默认值都不同。同一目录上多条规则叠加、或者规则写在 .htaccess 里但 AllowOverride 没放开 Limit,都会出现「配置改了但不生效」,最终以 405 形式暴露。调试时按 httpd -S 看虚拟主机命中,再逐级把规则注释掉复现。

3. 框架路由与反向代理的方法丢失

现代站点真正的 405 大头在这里:应用框架的路由只注册了 GET,前端却用 POST 提交;或者 RESTful 接口只允许 PUT,被 CDN 转成了 POST。此时 405 是应用返回的,配置层改什么都没用。识别方法很简单:看响应里有没有 Allow 头,以及有没有框架自己加的签名头(如 X-Powered-By、X-Frame-Options 的组合特征)。

五、按这个顺序查,一般 10 分钟内定位

  1. curl -i -X OPTIONS 抓 Allow,确认资源真实允许的方法集合。
  2. 把请求方法与业务预期对齐,排除「前端调错方法」这类最简单的情况。
  3. 确认返回 405 的层次:直连后端源站复现一次,再经代理复现一次,两次结果不同即为代理/WAF 层改写。
  4. 检查目录与文件权限(MDN 明确列了这条成因),尤其是上传目录、脚本执行目录属主与位。
  5. 如果是 TRACE 触发,判定为正常安全配置,不再继续排查。

六、常见问答

问:405 会让搜索引擎降权吗?
答:单个接口 405 不影响页面收录;但如果 HTML 页面本身返回 405(例如把 GET 禁掉了),那等于页面不可用,必须马上修。

问:501 和 405 怎么区分?
答:405 是「服务器认识这个动词,但该资源不支持」;501 Not Implemented 是「服务器根本不认识/没有实现这个动词」。MDN 在 405 页面末尾的 See also 里就把 501 Not Implemented、510 Not Extended 列为对照条目。

问:能不能直接让服务端永远返回 200 而不报 405?
答:不建议。405 + Allow 是 HTTP 语义的一部分,抹掉它会让客户端只能靠猜,反而会放大调用错误。

参考来源:MDN Web Docs《405 Method Not Allowed》《Allow header》,nginx ngx_http_core_module 指令文档,Apache HTTP Server 2.4 指令索引。

生产内容,同时打通搜索引擎(SEO)与AI搜索引擎(GEO)流量入口的软件! 点击进入365建站器 »