Laravel搜索仅单列表生效，联系人列表搜索无结果问题排查

从你描述的现象来看，核心问题是联系人列表与短信历史的搜索/渲染逻辑发生了混淆，以下是分步骤的排查和修复方案：

1. 先核对路由配置 #

首先确认两个功能的路由是否独立且指向正确的控制器方法，避免路由复用导致逻辑串线：

// 短信历史搜索路由
Route::get('/sms-history/search', [SmsHistoryController::class, 'search'])->name('sms.history.search');

// 联系人搜索路由（必须独立，不能和上面复用）
Route::get('/contacts/search', [ContactController::class, 'search'])->name('contacts.search');

• 检查路由名称是否唯一，禁止两个功能使用相同的name属性
• 确保联系人路由指向的是专门处理联系人逻辑的控制器方法

2. 修复控制器搜索逻辑 #

联系人搜索方法大概率误用了短信模型或短信表字段，修正示例如下：

// ContactController.php 中正确的搜索方法
public function search(Request $request)
{
    // 必须使用联系人模型，而非短信历史模型
    $query = \App\Models\Contact::query();

    if ($request->filled('search')) {
        $searchTerm = $request->input('search');
        // 针对联系人表的字段（姓名、手机号等）做模糊匹配
        $query->where(function ($q) use ($searchTerm) {
            $q->where('name', 'like', "%{$searchTerm}%")
              ->orWhere('phone_number', 'like', "%{$searchTerm}%");
        });
    }

    // 返回联系人数据，变量名建议用$contacts而非通用的$items，避免和短信历史混淆
    return view('contacts.index', [
        'contacts' => $query->paginate(15)
    ]);
}

• 绝对禁止在联系人搜索方法中调用SmsHistory模型
• 确保查询条件只涉及联系人表的字段，不要用短信表的message、send_time等字段

3. 修正视图渲染逻辑 #

你修改视图ID后出现短信字段，说明视图里的变量或表单指向错了：

3.1 修正搜索表单的提交地址 #

<!-- 联系人列表的搜索表单，必须指向联系人的搜索路由 -->
<form action="{{ route('contacts.search') }}" method="GET">
    <input type="text" name="search" placeholder="搜索姓名/手机号" value="{{ request('search') }}">
    <button type="submit">搜索</button>
</form>

3.2 修正表格渲染的变量和字段 #

<!-- 联系人表格（ID为contactTable） -->
<table id="contactTable">
    <thead>
        <tr>
            <th>姓名</th>
            <th>手机号</th>
            <th>备注</th>
        </tr>
    </thead>
    <tbody>
        <!-- 循环变量必须是控制器传递的$contacts，而非短信历史的$smshistory -->
        @foreach($contacts as $contact)
        <tr>
            <td>{{ $contact->name }}</td>
            <td>{{ $contact->phone_number }}</td>
            <td>{{ $contact->remark }}</td>
        </tr>
        @endforeach
    </tbody>
</table>

• 禁止在联系人视图中使用短信历史的变量名（比如$smsItems）
• 表格列必须渲染联系人表的字段，不要引用短信表的message、status等字段

4. 额外排查点 #

• 如果两个列表复用了同一个搜索组件，确保组件是动态接收路由和字段参数的，不要硬编码短信相关的配置
• 检查视图是否继承了错误的模板，导致变量被覆盖
• 清除Laravel缓存（php artisan cache:clear、php artisan view:clear），避免旧视图缓存导致的问题

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