Laravel 9 API空搜索查询无返回，求排查问题原因

核心问题点 #

• 路由匹配异常：你使用的{title?}可选路径参数，当传入空查询时，Laravel的路由匹配机制可能无法正确识别空参数的请求（比如/products/search/或/products/search），导致请求未命中目标路由，直接返回无内容或404。
• 参数判断不够严谨：原代码中$title == ''的判断，若路由参数未被正确传递，$title可能为null而非空字符串，此时会错误进入else分支；即便进入该分支，where('title', 'LIKE', '%%')理论上会返回所有数据，但前提是请求能命中路由。

修复方案 #

方案1：改用查询字符串传递参数（推荐） #

这种方式更符合RESTful API的搜索场景，同时避免路径参数的匹配歧义：

// 路由定义
Route::get('/products/search', [ProductController::class, 'searchTitle']);

// 控制器方法
public function searchTitle(Request $request)
{
    $pageSize = $request->page_size ?? 10;
    $title = $request->query('title', '');

    $query = Product::query();
    if ($title) {
        $query->where('title', 'LIKE', "%$title%");
    }

    return $query->paginate($pageSize);
}

请求示例：

• 空查询：GET /products/search
• 带关键词：GET /products/search?title=手机

方案2：修复原路由的匹配逻辑 #

若坚持使用路径参数，需添加正则约束确保空参数能被匹配，同时优化参数判断：

// 路由定义：添加正则约束允许空字符串参数
Route::get('/products/search/{title?}', [ProductController::class, 'searchTitle'])->where('title', '.*');

// 控制器方法优化
public function searchTitle(Request $request, ?string $title = null)
{
    $pageSize = $request->page_size ?? 10;

    $query = Product::query();
    if (!empty($title)) {
        $query->where('title', 'LIKE', "%$title%");
    }

    return $query->paginate($pageSize);
}

额外建议 #

• 优先使用查询字符串传递搜索关键词，避免路径中包含特殊字符导致的编码或匹配问题。
• 可添加参数验证逻辑，比如限制page_size的取值范围，防止恶意请求影响接口性能。

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