Laravel 11模块路由在浏览器/Postman可用但PHPUnit测试中找不到

核心原因 #

测试环境下模块的服务提供者未被正确注册，导致模块内的路由文件未加载，因此PHPUnit无法找到对应路由。

具体解决方案 #

1. 确认模块服务提供者的路由加载逻辑 #

检查Modules\User\Providers\UserProvider的boot方法，确保它正确加载模块路由：

public function boot()
{
    // 加载模块API路由
    $this->loadRoutesFrom(__DIR__ . '/../Routes/api.php');
    // 若有web路由需同步加载
    // $this->loadRoutesFrom(__DIR__ . '/../Routes/web.php');
}

同时确保该Provider未添加环境判断（如仅在生产环境加载），避免测试环境被排除。

2. 确保测试环境注册模块服务提供者 #

Laravel 11默认在bootstrap/providers.php中注册全局服务提供者，检查该文件是否包含你的模块Provider：

return [
    // 其他默认Provider
    Modules\User\Providers\UserProvider::class,
];

若不想全局注册，可在测试基类tests/TestCase.php的setUp方法中统一注册：

protected function setUp(): void
{
    parent::setUp();
    // 避免重复注册模块服务提供者
    if (! $this->app->getProvider(\Modules\User\Providers\UserProvider::class)) {
        $this->app->register(\Modules\User\Providers\UserProvider::class);
    }
    $this->withoutMiddleware();
}

3. 测试时强制刷新路由缓存 #

尽管Laravel测试默认禁用路由缓存，但如果存在缓存残留，可在测试中强制清除：

protected function setUp(): void
{
    parent::setUp();
    // 直接清除路由缓存，比artisan命令更高效
    \Illuminate\Support\Facades\Route::clearCachedRoutes();
    $this->withoutMiddleware();
}

4. 临时调试：手动加载路由文件 #

若以上方法未解决问题，可在测试中手动加载路由文件验证：

protected function setUp(): void
{
    parent::setUp();
    $this->withoutMiddleware();
    
    // 手动加载模块路由
    Route::prefix('user')->group(function () {
        require base_path('Modules/User/Routes/api.php');
    });
    
    // 可再次调试路由是否存在
    // dd(Route::getRoutes()->getByName('user.otp'));
}

验证步骤 #

修改测试代码后，先执行以下命令清除缓存：

php artisan config:clear
php artisan route:clear

再重新运行PHPUnit测试，确认路由是否能被正常识别。

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