Eloquent中HasMany关联使用with方法返回空集合问题

1. 确认关联方法的外键/本地键定义 #

虽然直接访问localidades能拿到数据，但预加载依赖明确的键匹配，务必在关联方法中显式指定外键和本地键，避免Laravel默认猜测出错：

// DepartamentoPersonalizado 模型
public function localidades()
{
    return $this->hasMany(LocalidadPersonalizada::class, 'departamento_id', 'id');
}

如果你的父模型主键不是id，或者子模型外键不是departamento_id（默认是父模型类名小写+_id），必须显式声明——预加载时Laravel靠这些键做批量关联查询，一旦不匹配就会返回空集合。

2. 排查全局作用域或模型约束 #

检查LocalidadPersonalizada模型是否有全局作用域（比如状态过滤、软删除）：

• 若用了软删除，且需要包含已删除的关联数据，在关联方法中加上withTrashed()：

public function localidades()
{
    return $this->hasMany(LocalidadPersonalizada::class)->withTrashed();
}

• 查看全局作用域的逻辑，比如是否有where('estado', 1)这类条件，直接访问时可能刚好查询到满足条件的子数据，但预加载是批量查询所有父模型的关联数据，部分父模型对应的子数据不满足约束就会返回空集合。

3. 验证主键与外键的数据类型一致 #

如果父模型主键是字符串（比如UUID），子模型外键却存为整数，或者反过来，直接访问时单个查询可能会隐式转换类型匹配，但预加载的whereIn查询不会自动转换，导致关联失败：

• 核对数据库表结构，确保DepartamentoPersonalizada.id和LocalidadPersonalizada.departamento_id的数据类型完全相同（比如都是INT或都是CHAR(36)）。

4. 检查模型的隐藏/可见属性 #

如果DepartamentoPersonalizada模型设置了$hidden属性包含localidades，预加载的数据会被隐藏，看起来是空集合，但实际数据存在。可以用$model->getAttributes()查看原始数据确认。

5. 查看预加载的SQL语句 #

开启查询日志对比预加载和直接访问的SQL差异：

// Tinker中执行
DB::enableQueryLog();
$departamentos = DepartamentoPersonalizado::with('localidades')->get();
dd(DB::getQueryLog());

对比直接访问$departamento->localidades生成的SQL，看预加载的WHERE条件是否正确，有没有字段名错误、类型不匹配等问题。

解决完上述问题后，就可以在DepartamentoPersonalizada模型中设置默认预加载：

protected $with = ['localidades'];

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