如何访问Laravel Resource资源路由下控制器的自定义方法？

Laravel 内置的 apiResource 路由仅默认绑定5个 RESTful 标准方法（index、show、store、update、destroy），不会自动匹配你在控制器中新增的自定义方法，这是你访问 /categories/test 无法触发对应逻辑的核心原因。

如果不想为每个自定义方法单独声明路由，可以通过以下方案实现：

方案1：添加通用万能路由（适合大量自定义方法的场景） #

在原有资源路由前面添加一条通用匹配路由，自动映射路径对应的控制器方法，代码示例：

// 匹配GET请求下categories后接任意合法方法名的路径，可根据需求修改支持的请求类型
Route::get('categories/{action}', [CategoriesController::class, '{action}'])
    ->where('action', '[a-zA-Z0-9_]+');

// 原有资源路由必须放在通用路由之后
Route::apiResource("categories", CategoriesController::class);

配置完成后访问 /categories/test 即可自动触发 test() 方法，需要支持POST等其他请求类型时，把 get 改为 match(['get', 'post']) 或者 any 即可。

方案2：追加单条自定义路由（更安全的最佳实践） #

如果自定义方法数量不多，更推荐单独声明自定义路由，避免暴露控制器内的所有公共方法，代码示例：

// 自定义路由必须放在资源路由前面
Route::get('categories/test', [CategoriesController::class, 'test']);
Route::apiResource("categories", CategoriesController::class);

注意：路由匹配遵循从上到下的优先级规则，自定义路由如果放在资源路由后面，会被资源路由的 /categories/{category} 规则拦截，把 test 当作资源ID匹配到show方法，导致自定义路由失效。

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