Laravel路由报错：Invalid route action [Auth\SignInController] 求助

问题场景 #

在Laravel项目中创建了带有__invoke方法的单动作控制器（SignInController、SignOutController、MeController），并在routes/api.php中通过命名空间分组注册路由，请求时触发错误：Invalid route action [Auth\SignInController] "UnexpectedValueExpection"。

路由代码：

<?php

use Illuminate\Support\Facades\Route;


Route::group(['prefix' => 'auth', 'namespace' => 'Auth'], function () {
    Route::post('signin', 'SignInController');
    Route::post('signout', 'SignOutController');

    Route::get('me', 'MeController');
});

控制器示例（SignInController）：

<?php

namespace App\Http\Controllers\Auth;

use App\Http\Controllers\Controller;
use Illuminate\Http\Request;

class SignInController extends Controller
{
    public function __invoke()
    {
        dd('Sign In');
    }
}

解决办法 #

这个错误是因为Laravel无法正确解析路由中指定的控制器动作，根据Laravel版本不同，可采用以下两种修复方式：

方式一：使用控制器完整类名引用（推荐） #

直接在路由中通过::class语法指定控制器的完整类名，同时可以保留前缀分组：

<?php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\Auth\SignInController;
use App\Http\Controllers\Auth\SignOutController;
use App\Http\Controllers\Auth\MeController;

Route::group(['prefix' => 'auth'], function () {
    Route::post('signin', SignInController::class);
    Route::post('signout', SignOutController::class);
    Route::get('me', MeController::class);
});

这种写法是Laravel官方推荐的方式，能彻底避免命名空间解析错误，代码可读性也更强。

方式二：恢复路由自动命名空间配置（适配Laravel 8+） #

Laravel 8及以上版本默认移除了路由自动添加App\Http\Controllers命名空间的设置，若想保留原有路由简写方式，需修改App\Providers\RouteServiceProvider.php：

1. 确保类中存在protected $namespace = 'App\\Http\\Controllers';属性；
2. 在boot方法的路由注册闭包中添加namespace($this->namespace)：

public function boot()
{
    $this->configureRateLimiting();

    $this->routes(function () {
        Route::prefix('api')
            ->middleware('api')
            ->namespace($this->namespace)
            ->group(base_path('routes/api.php'));

        Route::middleware('web')
            ->namespace($this->namespace)
            ->group(base_path('routes/web.php'));
    });
}

修改完成后，原有路由写法即可正常工作。

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