Laravel hasMany关联如何按ID正确查询单条指定关联记录

云原生阿岚

2026-8-28

问题原因

你写的预加载逻辑返回空数组，核心是三个常见问题：

关联定义依赖Laravel默认约定，未手动指定关联字段，如果你的表字段名和约定不一致，会直接导致关联匹配失败。hasMany的默认规则是：关联表（company_single_props）用company_id作为外键，关联父表（companies）的主键id，只要有一个字段名不符合这个规则，关联查询就会用错误的字段做匹配。
仅在with闭包中加条件只会筛选关联返回的内容，不会过滤父模型Company的数据。如果你查出来的某条公司记录本身没有对应ID的属性记录，该条记录下的single_properties就会是空数组。
hasMany关联返回的是集合类型，哪怕匹配到数据也是长度为1的集合，不符合你要获取单条记录的语义，后续处理也容易出错。

调整方案

先修正关联定义，明确指定关联字段，彻底规避约定不匹配问题：

// Company模型中的关联定义
public function single_properties(): HasMany
{
    // 参数依次为：关联模型类名、关联表外键字段、父表本地关联键
    return $this->hasMany(CompanySingleProps::class, 'company_id', 'id');
}

如果你需要过滤掉没有该指定属性的公司，同时只返回目标属性记录，需要搭配whereHas做父模型过滤，避免出现空关联条目：

$targetPropId = $coordsPropId->id;
$companyList = Company::with(['single_properties' => function($query) use($targetPropId) {
        // 带表名前缀写条件，避免多表连表时字段歧义
        $query->where('company_single_props.id', $targetPropId);
    }])
    ->where('is_hidden', false)
    // 过滤掉不存在目标属性的公司记录
    ->whereHas('single_properties', function($query) use($targetPropId) {
        $query->where('company_single_props.id', $targetPropId);
    })
    ->get()
    ->toArray();

如果你希望关联结果直接返回单条记录结构（而非嵌套在集合里），可以额外定义一个hasOne类型的关联适配单条查询场景：

// Company模型中新增单条属性匹配关联
public function target_single_prop(): HasOne
{
    return $this->hasOne(CompanySingleProps::class, 'company_id', 'id');
}

查询时直接调用该关联即可，返回的target_single_prop就是单条模型结构：

$targetPropId = $coordsPropId->id;
$companyList = Company::with(['target_single_prop' => function($query) use($targetPropId) {
        $query->where('company_single_props.id', $targetPropId);
    }])
    ->where('is_hidden', false)
    ->whereHas('target_single_prop', function($query) use($targetPropId) {
        $query->where('company_single_props.id', $targetPropId);
    })
    ->get()
    ->toArray();

额外排查点

先手动查库确认$coordsPropId->id对应的CompanySingleProps记录真实存在，且该记录的company_id值确实属于is_hidden=0的公司数据，否则逻辑正确也会查不到结果。
如果你的模型开启了软删除，还要确认关联记录、父模型记录都没有被软删除。

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