Laravel 7 API搜索功能路由配置无效返回全量数据问题求助

• 路由匹配顺序错误：Laravel路由按照从上到下的顺序匹配，自定义路由必须放在apiResource路由之前，否则会优先匹配到资源路由的对应方法
• 路由路径不匹配：你新增的Route::get('search', 'ActorController@search')对应的请求路径是/api/search，但你实际请求的是/api/actors?search=Laney，命中的是apiResource自动生成的index方法，根本没有走到search方法，所以返回全量数据

方案1：保留独立search方法（推荐，职责更清晰） #

1. 修改routes/api.php配置，调整路由顺序和路径：

// 自定义搜索路由必须放在apiResource之前
Route::get('actors/search', 'ActorController@search');
Route::apiResource('actors','ActorController');

2. Postman调整请求地址为：GET /api/actors/search?search=Laney即可触发search方法的逻辑

方案2：复用index方法（无需新增路由） #

如果不需要独立的搜索接口，直接在资源控制器的index方法中增加搜索判断即可，不需要新增路由：

public function index(Request $request)
{
    try {
        $query = Actor::orderBy("updated_at", "desc");
        // 存在search参数时执行过滤
        if ($request->filled('search')) {
            $query->where('name', 'LIKE', '%' . $request->search . '%');
        }
        return response()->json($query->get(), 200);
    } catch (Exception $exception) {
        return response()->json(['error' => $exception->getMessage()], 500);
    }
}

修改后直接请求原地址/api/actors?search=Laney即可返回匹配结果。

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