Laravel Eloquent多态关联WhereHasMorph报错：列不存在

核心问题1：morphMany关联参数传递错误 #

你在Person模型中定义digitalContacts关联时，错误地颠倒了morphMany的参数顺序：

// 错误写法
return $this->morphMany(DigitalContact::class, 'digital_contactable', 'digital_contactable_type');

morphMany的参数规则是：

1. 关联模型类名
2. 多态关联的名称（对应关联模型中morphTo的名称）
3. 可选：多态关联的_id外键列名（默认是关联名称_id，即digital_contactable_id）
4. 可选：多态关联的_type外键列名（默认是关联名称_type，即digital_contactable_type）

你把第三个参数填成了digital_contactable_type，导致Laravel误以为这个字段是_id列，进而生成错误的SQL，去people表中查找不存在的digital_contactable_type列。

修正关联定义 #

你的表结构完全符合Laravel多态关联的默认命名规范，直接省略可选参数即可：

class Person extends Model
{
    public function digitalContacts()
    {
        return $this->morphMany(DigitalContact::class, 'digital_contactable');
    }
    // ...
}

如果需要显式指定参数，必须保证顺序正确：

return $this->morphMany(
    DigitalContact::class,
    'digital_contactable',
    'digital_contactable_id', // 指定_id列
    'digital_contactable_type' // 指定_type列
);

核心问题2：错误使用whereHasMorph方法 #

whereHasMorph是针对**morphTo类型关联**的查询方法，用于过滤关联到不同模型类型的记录。而你的场景是从Person出发，查询拥有符合条件的digitalContacts（morphMany关联）的Person，应该使用普通的whereHas方法。

修正查询代码 #

将orWhereHasMorph替换为whereHas（单一条件下无需or前缀）：

$personQuery = Person::query();
$column = 'value';
$needle = '%09133333%';

$personQuery->whereHas('digitalContacts', function ($contactQuery) use ($column, $needle) {
    $contactQuery->where($column, 'like', $needle);
    // 注意：你之前写了'%' . $needle . '%'，但needle本身已包含%，会变成%%09133333%%，需根据实际需求调整
});

$data = $personQuery->get();

如果需要结合其他条件使用or逻辑，再保留orWhereHas：

$personQuery->orWhereHas('digitalContacts', function ($contactQuery) use ($column, $needle) {
    $contactQuery->where($column, 'like', $needle);
});

为什么之前whereHas条件未生效？ #

因为关联定义错误，Laravel无法正确识别关联关系，导致whereHas的过滤条件没有被正确注入到查询中，最终返回了全部数据。修正关联定义后，whereHas就能正常工作了。

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