Laravel9测试GET自动补语言前缀POST请求报405问题

问题背景 #

• 运行环境：项目初始基于Laravel 5.4开发，后续升级至Laravel 9版本。
• 路由配置：路由组绑定locale多语言中间件，配置可选多语言前缀{locale?}，组内定义/signin的GET、POST路由，分别指向Front\UsersController@getSignin、Front\UsersController@postSignin，路由定义代码：

Route::group(['middleware' => 'locale', 'prefix' => '{locale?}'], function () {
    Route::get('/signin', 'Front\UsersController@getSignin');
    Route::post('/signin', 'Front\UsersController@postSignin'); 
});

• 异常现象：
  浏览器访问时两条路由均正常，直接访问/signin会自动跳转至带默认语言前缀的/am/signin；
  编写Feature测试时，$this->get('/signin')正常返回302状态码，手动指定带前缀路径$this->post('am/signin')可返回302，直接调用$this->post('/signin')却返回405 Method Not Allowed状态码，未像GET请求一样自动补全语言前缀匹配路由。
• 已尝试无效排查方案：
  • 测试时调用withoutMiddleware()移除全部或仅locale中间件
  • 将路由前缀从可选{locale?}改为必填{locale}
  • 注释/signin的GET路由定义
• 对照验证结果：
  新建干净Laravel 9项目配置相同路由时，不带前缀访问GET/POST/test均返回404，手动带/am前缀才返回200；
  当前升级项目不带前缀访问GET/signin返回200（关闭中间件时返回$errors未定义的500视图错误），POST/signin返回405，路由匹配逻辑存在异常。

根因分析 #

这个问题是Laravel跨大版本升级的典型遗留问题，核心原因有两个：

1. 路由注册逻辑残留：Laravel 5.4到9的RouteServiceProvider路由注册规则存在差异，升级时如果没有完全替换app/Providers/RouteServiceProvider.php为新版本默认逻辑，旧版本的隐式根路由绑定会残留，导致不带前缀的GET/signin被额外注册到根路由下，POST路由没有同步注册，因此POST请求匹配时会找到同路径仅支持GET的路由，直接返回405。
2. 中间件逻辑缺陷：原有locale中间件对所有不带前缀的请求统一做重定向处理，但POST请求属于非幂等请求，测试环境下重定向会丢失POST请求体和请求方法，最终匹配到GET路由触发405；浏览器端访问正常是因为页面表单提交时已经生成了带正确语言前缀的action地址，不会走到无前缀的POST请求逻辑。

修复步骤 #

1. 清理路由缓存
   执行以下命令清除所有缓存的路由文件，同时手动删除bootstrap/cache/routes-v7.php（Laravel9的路由缓存文件），避免旧版本生成的缓存干扰路由匹配：

php artisan route:clear
php artisan config:clear

2. 修正RouteServiceProvider配置
   对照Laravel 9官方默认的RouteServiceProvider代码，更新项目中的该文件，重点确认boot方法内的路由注册逻辑没有为web路由添加多余的根路径隐式绑定，删除所有5.4版本遗留的自定义路由全局规则。
3. 优化locale中间件逻辑
   不要对非GET请求做重定向处理，直接为请求注入默认语言参数，避免POST请求重定向丢失方法和参数：

public function handle(Request $request, Closure $next)
{
    $locale = $request->route('locale');
    // 无语言前缀时设置默认语言
    if (is_null($locale)) {
        $locale = config('app.fallback_locale', 'am');
        if ($request->isMethod('get')) {
            // GET请求直接重定向到带前缀路径
            return redirect(url($locale . $request->getPathInfo()));
        }
        // 非GET请求直接给路由参数赋值，不做重定向
        $request->route()?->setParameter('locale', $locale);
    }
    app()->setLocale($locale);
    return $next($request);
}

4. 测试用例适配
   Feature测试POST请求时，不要依赖无前缀路径的自动跳转，要么手动拼接语言前缀，要么在测试基类中统一给请求添加默认locale前缀，符合实际业务的请求路径逻辑。

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