部署在AWS Elastic Beanstalk的Laravel POST路由被识别为GET路由问题

问题描述 #

开发环境下所有路由正常工作，但部署到AWS Elastic Beanstalk后，POST请求被当作GET请求处理，导致功能失效。例如登出表单提交后，抛出MethodNotAllowedException异常，提示：

The GET method is not supported for this route. Supported methods: POST.

示例代码 #

登出表单：

<form method="post" action="{{route('logout')}}">
  @csrf

  <button type="submit" class="btn btn-icon btn-primary">
    <i class="fa-regular fa-right-from-bracket fs-4"></i>
  </button>
</form>

对应的Laravel Breeze路由：

Route::post('logout', [AuthenticatedSessionController::class, 'destroy'])
    ->name('logout');

解决方案 #

1. 修复负载均衡器重定向导致的方法丢失 #

AWS Elastic Beanstalk的负载均衡器默认会将HTTP请求重定向到HTTPS，这个过程可能会把POST请求转为GET。可以通过两种方式解决：

• 在Laravel中强制HTTPS：在app/Providers/AppServiceProvider.php的boot方法中添加代码，避免依赖负载均衡器的重定向：

  use Illuminate\Support\Facades\URL;
  
  public function boot()
  {
      if ($this->app->environment('production')) {
          URL::forceScheme('https');
      }
  }
  

• 修改负载均衡器规则：登录AWS控制台，进入对应Elastic Beanstalk环境的负载均衡器配置，调整重定向规则，确保保留原请求方法。

2. 验证CSRF令牌与配置一致性 #

POST请求被转为GET可能是CSRF验证失败触发的Laravel安全机制，检查以下内容：

• 确认.env文件中的APP_URL与部署后的域名完全一致（包括HTTPS前缀）。
• 清除生产环境的配置和缓存：

  php artisan config:clear
  php artisan cache:clear
  

3. 检查Web服务器配置 #

• Apache环境：确保项目根目录的.htaccess文件正确部署，Laravel默认的.htaccess负责处理请求转发，内容如下：

  <IfModule mod_rewrite.c>
      <IfModule mod_negotiation.c>
          Options -MultiViews -Indexes
      </IfModule>
  
      RewriteEngine On
  
      # Handle Authorization Header
      RewriteCond %{HTTP:Authorization} .
      RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
  
      # Redirect Trailing Slashes If Not A Folder...
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteCond %{REQUEST_URI} (.+)/$
      RewriteRule ^ %1 [L,R=301]
  
      # Send Requests To Front Controller...
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteCond %{REQUEST_FILENAME} !-f
      RewriteRule ^ index.php [L]
  </IfModule>
  

• Nginx环境：通过.ebextensions目录添加自定义配置，确保请求正确转发到Laravel入口文件：
  创建.ebextensions/nginx.conf文件，内容如下：

  files:
    "/etc/nginx/conf.d/laravel.conf":
      mode: "000644"
      owner: root
      group: root
      content: |
        location / {
            try_files $uri $uri/ /index.php?$query_string;
        }
  

4. 清除路由缓存 #

如果生产环境生成了路由缓存，可能导致路由更新未生效，执行以下命令清除：

php artisan route:clear

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