Eloquent查询中whereHas块关联字段选择失败问题排查

遇到这个问题很常见，我来帮你理清楚连锁错误的根源：

1. 首先MySQL抛出的Unknown column 'custom_records.custom_title' in 'field list'是核心问题——你用的whereHas方法并没有将custom_records表和主表records做关联查询（JOIN）。whereHas本质是通过子查询检查关联记录是否存在，它不会把关联表加入到主查询的表列表里，所以当你在get()里直接选择custom_records.custom_title时，MySQL找不到这个表的字段。
2. 而Laravel返回的The Response content must be a string or object implementing __toString(), "boolean" given错误，是因为前面的SQL查询失败，返回了布尔值false，框架尝试把这个布尔值作为响应内容返回，就触发了这个格式错误。

要选择关联表的字段，你需要主动将custom_records表通过join或leftJoin方法加入到查询中，以下两种方案可以根据你的需求选择：

方法一：直接使用JOIN替代whereHas #

如果你的需求只是筛选出存在符合条件的custom_records并获取该表字段，直接用JOIN更高效：

$record = $this->record->newQuery();
// 注意：这里的关联条件要和你的CustomRecord模型定义的外键一致，比如假设外键是record_id
$record->leftJoin('custom_records', 'records.id', '=', 'custom_records.record_id')
       ->where('custom_records.custom_title', 'like', '%'.$searchTerm.'%');

return $record->get([
    'records.id',
    'records.another_field',
    'records.another_field_2',
    'custom_records.custom_title',
]);

方法二：保留whereHas同时添加JOIN #

如果你需要保留whereHas的复杂关联检查逻辑（比如多对多关联、嵌套关联的存在性判断），可以同时添加JOIN来关联表：

$record = $this->record->newQuery();
$record->whereHas('customRecords', function ($query) use ($searchTerm) {
    $query->where('custom_title', 'like', '%'.$searchTerm.'%');
})
// 确保关联条件和模型定义一致
->join('custom_records', 'records.id', '=', 'custom_records.record_id');

return $record->get([
    'records.id',
    'records.another_field',
    'records.another_field_2',
    'custom_records.custom_title',
]);

• 关联条件正确性：一定要确认join里的外键关联和你的模型定义匹配，比如如果CustomRecord模型的关联是public function record() { return $this->belongsTo(Record::class, 'record_id'); }，那么关联条件就是records.id = custom_records.record_id。
• 去重处理：如果是一对多关联（一个Record对应多个CustomRecord），JOIN之后可能会返回重复的Record记录，这时候可以添加->distinct()来去除重复：

  $record->leftJoin(...)
         ->where(...)
         ->distinct();
  

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