Laravel中如何按API分组路由？自定义apiResource路由失效解决

问题原因 #

Route::apiResources() 是Laravel专门用于生成RESTful资源路由的方法，它的参数要求是「路由URI」对应「资源控制器类」，会自动生成该控制器的标准资源路由（如index/show/store等）。你尝试添加的'register/code/verify' => [RegisterVerifyController::class, 'verify']是单个动作的自定义路由，不符合apiResources的参数规则，因此配置无效。

正确解决方案 #

因为你的路由定义在routes/api.php文件中，该文件本身已经被Laravel默认包裹在Route::prefix('api')的路由组内，所以直接单独定义自定义路由即可自动带上api/前缀：

// routes/api.php
Route::apiResources([
    'profile' => ProfileController::class,
    'specialization' => SpecializationController::class,
    'specialization/filter' => SpecializationController::class,
]);

// 单独定义自定义路由，自动继承api前缀
Route::post('register/code/verify', [RegisterVerifyController::class, 'verify']);

• 注意：根据业务需求调整请求方法（比如get/post/put等），确保和前端请求方法一致。
• 可执行php artisan route:list命令查看路由列表，确认api/register/code/verify是否生成成功。

额外说明 #

如果路由不在routes/api.php中，可手动用路由组包裹来添加api前缀：

Route::prefix('api')->group(function () {
    Route::apiResources([
        // 资源路由配置
    ]);

    Route::post('register/code/verify', [RegisterVerifyController::class, 'verify']);
});

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