Laravel HTTPS环境下POST请求报错：不支持GET方法

本地开发的Laravel网站部署到HTTPS服务器后，API POST请求失效。具体情况：

• 在routes/api.php中定义路由：Route::post('/shop/search', SearchController::class);
• 调用地址：https://server.example/api/shop/search
• 单元测试中POST请求正常，但Postman等客户端请求时报错：{"message":"The GET method is not supported for route api/shop/search. Supported methods: POST."}
• 将路由改为GET可正常工作，已尝试以下方案但无效：
  • 确认请求方法未混淆
  • 在\App\Http\Middleware\VerifyCsrfToken.php中禁用所有路由的CSRF验证
  • 检查Nginx无重定向
  • 执行php artisan optimize:clear清除缓存
  • 请求头添加Content-Type: application/json和Accept: application/json
  • php artisan route:list显示该路由为POST路由

排查方向与解决方法 #

1. 修正Nginx的HTTPS重定向规则 #

HTTP转HTTPS的重定向如果使用301/302状态码，部分客户端会将POST请求转为GET。需改用307临时重定向保留请求方法：

server {
    listen 80;
    server_name server.example;
    # 307会保留原请求方法和内容
    return 307 https://$server_name$request_uri;
}

同时确保HTTPS服务器块的Laravel路由处理配置正确：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

修改后重启Nginx：sudo systemctl restart nginx

2. 配置Laravel信任反向代理 #

若服务器使用了Cloudflare、负载均衡等反向代理，需让Laravel识别真实的请求协议和方法：
修改app/Http/Middleware/TrustProxies.php：

<?php

namespace App\Http\Middleware;

use Illuminate\Http\Request;
use Fideloper\Proxy\TrustProxies as Middleware;

class TrustProxies extends Middleware
{
    // 生产环境建议指定具体代理IP，而非*
    protected $proxies = '*';

    protected $headers = Request::HEADER_X_FORWARDED_ALL;
}

同时确保反向代理已传递X-Forwarded-Proto、X-Forwarded-For等请求头。

3. 检查服务器安全模块/防火墙 #

部分服务器的安全模块（如ModSecurity）或防火墙规则可能篡改请求方法，导致Laravel接收到GET请求：

• 临时关闭安全模块测试（如sudo a2enmod -s modsecurity）
• 查看Nginx访问日志确认请求方法：

  tail -f /var/log/nginx/access.log | grep /api/shop/search
  

  若日志显示请求为GET，说明请求在到达Laravel前已被修改，需排查上游代理或防火墙规则。

4. 彻底清除Laravel缓存 #

执行以下命令确保路由、配置缓存完全清除：

php artisan route:clear
php artisan config:clear
php artisan cache:clear

若生产环境使用了路由缓存，修改路由后需重新生成：

php artisan route:cache

5. 验证客户端实际请求 #

用curl命令直接测试，查看请求过程是否有异常：

curl -X POST -H "Content-Type: application/json" -d '{}' https://server.example/api/shop/search -v

通过输出确认：

• 请求方法是否为POST
• 是否存在重定向（状态码3xx）
• 服务器返回的响应内容和状态码

内容的提问来源于stack exchange，提问作者Александр Инженер