Laravel API在共享主机上提交3500条产品的大POST请求报405 Not Allowed错误

这类请求体体积越大越容易触发、本地环境正常、共享主机环境报错的405 Not Allowed，完全不是Laravel路由定义的逻辑错误，问题出在请求到达Laravel应用之前的Web服务器层：

• 本地开发环境对请求体大小无严格限制，携带3500条产品JSON的POST请求可以完整透传到Laravel的路由匹配流程，因此表现正常
• 共享主机默认配置的Web服务器请求体大小阈值远低于3500条JSON的实际体积（多数主机默认将请求体上限设置为1-2M），当POST请求的体积超过阈值时，服务器不会将请求转发给Laravel的入口文件public/index.php处理
• 部分主机为了隐藏服务器配置细节，不会返回标准的413 Payload Too Large错误，而是通过内部跳转篡改请求方法、拦截请求流程，最终让Laravel的路由匹配到不对应的HTTP方法，抛出405报错。部分主机自带的WAF/ModSecurity规则也会将大体积POST请求判定为异常流量，直接返回405拦截请求。

1. 先验证请求是否到达Laravel层
   在自定义中间件api_import的处理逻辑最开头，添加请求日志记录代码，确认大体积请求是否真的进入了应用流程：

   // app/Http/Middleware/ApiImport.php 的handle方法首行
   Log::info('收到API导入请求', [
       'request_method' => $request->method(),
       'request_size' => $request->header('Content-Length'),
       'request_uri' => $request->path()
   ]);
   

   发送3500条全量产品的请求后，如果日志中没有对应记录，即可确认请求是被Web服务器层拦截，没有到达Laravel。
2. 调整Web服务器的请求体大小限制
   如果是Apache架构的共享主机，可以在项目public目录下的.htaccess文件中追加配置，放开20M以内的请求体限制：

   # 允许最大20M的POST请求体，匹配全量导入的数据体积
   LimitRequestBody 20971520
   php_value post_max_size 20M
   php_value upload_max_filesize 20M
   php_value memory_limit 256M
   

   如果是Nginx架构的共享主机，需要在主机管理面板中找到网站配置的「客户端请求最大体积」选项，将阈值调整到20M以上——注意这类配置必须在Web服务器层修改，仅调整Laravel或PHP层面的配置不会生效，因为请求根本无法到达PHP解析环节。
3. 排查WAF安全规则的拦截
   登录主机的管理面板，查看安全拦截日志，找到对应请求时间的拦截记录，如果确认是WAF规则将大体积POST判定为攻击流量，将/products、/categories的POST导入接口加入WAF白名单即可。
4. 兜底适配方案
   如果主机商不允许放开大请求体的限制，可以调整接口的导入逻辑，取消一次性传输3500条全量数据的设计，改为分批提交：每次传输100-200条产品数据，分20次左右完成全量导入。这种方式不仅可以避开服务器的请求体大小限制，也能降低单次请求的PHP执行时长，减少触发主机超时限制的概率。

内容的提问来源于stack exchange，提问作者Pera Detlic