记一次解决接口报错 The GET method is not supported for this route. Supported methods: POST.
的bug;
问题表现:
服务器上部署了两套相同代码的项目A和B,分别以不同的域名访问,提交代码时同步更新。以POST
方式请求某个特定接口时,A能够正常响应,B却无论如果都是报错The GET method is not supported for this route. Supported methods: POST.
奇怪的是,本地开发是正常的,无法复现此bug, 线上服务器里A项目亦是正常访问,B项目代码与A完全相同,仅配置文件.env
与域名授权文件不同。
搜索解决方法,尝试
php artisan route:clear
php artisan route:cache
问题依旧,通过
php artisan route:list
打印出项目的所有路由,发现B项目的路由是正确的,推测问题可能与项目无关;打开B项目的
Debug
设置,显示该报错的追踪路径,发现框架对该请求的Method
判断为GET
, 而该路由所定义方法为POST
,所以直接抛出错误The GET method is not supported for this route. Supported methods: POST.
问题查到这里陷入了死胡同,我无法理解为什么以
POST
发起的请求,流程达到框架中处理时, 请求的Method
会变成GET
;
纠结一天没有结果。第二天判断可能是
nginx
到框架过程中出的问题,尝试调取Nginx
的Access日志来判断问题原因,终于发现127.0.0.1 - - [02/Mar/2022:11:29:48 +0800] "POST /api_path/action_name HTTP/1.1" 301 162 "-" "PostmanRuntime/7.29.0"
127.0.0.1 - - [02/Mar/2022:11:29:49 +0800] "GET /api_path/action_name HTTP/1.1" 405 26147 "http://host_domain/api_path/action_name" "PostmanRuntime/7.29.0"
在
Nginx
这里,POST
请求被301重定向成GET
,以GET
去请求POST
的路由当然会报错;而这个301则是宝塔环境自带的“强制HTTPS”的设置导致,开启该设置之后,nginx
的配置文件会增加以下代码#HTTP_TO_HTTPS_START
if ($server_port !~ 443){
rewrite ^(/.*)$ https://$host$1 permanent;
}
至此,关闭该“强制HTTS"的设置,问题解决。
【记一次奇怪的接口报错及解决】后记:一般情况下301重定向强制HTTPS用于网站首页为主,网站首页一般情况下都是
GET
请求,自然也就不会存在POST
变成GET
的困扰。关于301的
POST
转GET
问题,可以参考记一次HTTP POST请求变成GET请求