Laravel 10自动补全搜索异常：疑因隐式路由绑定导致

问题核心 #

使用bootstrap-typeahead.js实现单词自动补全时，预期执行前缀匹配word字段的SQL，但实际生成的SQL为：

select * from words_test where slug = 'autocomplete' limit 1

该查询与控制器中的LIKE逻辑完全不符，根源是隐式路由绑定冲突。

排查原因 #

Laravel的隐式路由绑定会自动将路由中的参数（如{wordTest}）解析为对应模型实例。若你的路由定义中，自动补全路径words/autocomplete被模型绑定路由拦截，Laravel会把autocomplete当作模型的路由键（默认是主键，若模型设置slug为路由键则用slug）去查询，从而生成上述错误SQL。

解决方案 #

1. 调整路由顺序与定义 #

确保自动补全路由优先于模型绑定路由，避免autocomplete被当作模型参数解析：

// 先定义自动补全路由
Route::get('words/autocomplete', [WordTestController::class, 'autocomplete']);

// 再定义模型绑定路由（若业务需要）
Route::get('words/{wordTest}', [WordTestController::class, 'show']);

若之前将自动补全路由放在模型绑定路由之后，Laravel会优先匹配模型绑定规则，导致错误触发。

2. 修正控制器代码BUG #

控制器中查询的是word字段，但循环时引用了不存在的mot_origine属性，会导致返回空数据，需修正：

public function autocomplete(Request $request) {
    $query = $request->get('term');
    // 仅查询需要的word字段
    $datas = WordTest::select('word')
                    ->where('word', 'LIKE', $query . '%')
                    ->get();
    // 直接提取word属性，简化逻辑
    $dataModified = $datas->pluck('word')->toArray();
    
    return response()->json($dataModified);
}

3. 检查模型路由键设置 #

若模型中设置了自定义路由键：

public function getRouteKeyName()
{
    return 'slug';
}

需确保路由参数位置不会和autocomplete这类固定路径词重叠，避免路由匹配混淆。

验证测试 #

修改完成后，触发自动补全请求，检查执行的SQL是否变为：

select `word` from `words_test` where `word` like ?

同时确认返回的JSON数据为匹配的单词列表，前端typeahead正常显示补全选项。

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