Nginx生产环境部署后Laravel Livewire失效报请求方法不支持错误

该报错的核心逻辑是：Livewire 用于组件交互的 /livewire/message/* 接口仅接受 POST 请求，但在 Nginx 环境下该请求被规则触发了 301/302 跳转，所有主流浏览器收到这类跳转响应时，会自动将原 POST 请求转为 GET 请求访问跳转后的地址，最终触发方法不允许异常。
相同代码在 Apache 环境运行正常，是因为 Laravel 自带的 public/.htaccess 已经预配置了重写规则，不会触发这类意外跳转。

按出现概率从高到低排序：

• public 目录下 livewire 静态资源目录触发 Nginx 自动斜杠补全跳转
  执行过 php artisan livewire:publish 发布静态资源后，项目 public 目录下会生成 livewire 文件夹存放 livewire.js 等前端文件。绝大多数网上流传的 Nginx Laravel 配置中，try_files 规则都会写 $uri/ 项用于匹配目录，当 POST 请求打到 /livewire/message/组件名 路径时，Nginx 会匹配到已存在的 public/livewire 目录，自动返回 301 响应给请求路径末尾补斜杠，直接触发 POST 转 GET 的逻辑。
  修复二选一即可：
  1. 新增专属规则让 Livewire 消息端点直接走 Laravel 路由，绕开静态文件匹配逻辑：

     location ^~ /livewire/message {
         try_files /index.php?$query_string =404;
     }
     

  2. 调整全局重写规则，去掉不必要的目录匹配项（Laravel 项目不需要 Nginx 处理目录自动补斜杠，这类路径归一化逻辑交给框架处理即可）：

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

• 强制跳转规则未保留请求方法
  检查 Nginx 中所有跳转规则，包括 HTTP 转 HTTPS、非 www 域名转 www、末尾斜杠归一化规则：
  • 如果规则使用 return 301 或 return 302，一旦匹配到 Livewire 的 POST 请求，就会触发 POST 转 GET 的问题
  • 修复方式：将需要兼容 POST 请求的跳转规则改用 307 状态码，307 会强制浏览器保留原请求方法、请求体不做修改；或者调整规则优先级，确保 /livewire/message/* 路径不会被这类跳转规则匹配。同时检查项目 .env 中 APP_URL 的协议、域名和实际访问地址完全一致，避免 Livewire 生成的接口地址和站点实际协议/域名不匹配，触发跨域或跳转。
• Laravel 路由重写规则配置错误
  检查 Nginx 的 PHP 处理配置，确保所有不存在的静态路径都能正确转发给 public/index.php 处理，不要遗漏查询参数传递，错误的重写规则会导致 Livewire 注册的路由无法被框架正确匹配。标准 Laravel Nginx 的 PHP 处理片段参考（替换为你实际的 PHP-FPM 监听地址即可）：

  location ~ \.php$ {
      fastcgi_pass unix:/run/php/php8.2-fpm.sock;
      fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
      include fastcgi_params;
  }
  

• 缓存清理校验
  调整完 Nginx 配置先执行 nginx -t 校验语法正确性，再重载 Nginx 服务。之后在项目根目录执行以下命令清除框架缓存，避免旧配置干扰：

  php artisan config:clear
  php artisan route:clear
  php artisan livewire:publish --assets
  

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