Laravel关联模型加载异常：查询MeterReading时加载全部Client问题

我有两个模型：MeterReading和Client，一个Client可对应多条MeterReading。关联关系定义如下：

Client模型中的关联：

public function readings()
{
    return $this->hasMany(MeterReading::class)->orderByDesc('created_at');
}

MeterReading模型中的关联：

public function client()
{
    return $this->belongsTo(Client::class)->withTrashed();
}

两个模型均在protected $with中定义了关联预加载。当执行如下查询获取指定年月的MeterReading时：

$readings= MeterReading::where('month', $this->month)
    ->where('year', $this->year)
    ->orderByDesc('meter_readings.created_at')->paginate($this->perPage);

系统却加载了全部4000条Client记录，排查发现Client查询语句为：

select * from `clients` where `clients`.`id` in (0, 0, 0, 0, 0, 0, 0, 0, 0, 0)

已知数据库迁移定义正确，clients.id与client_id类型匹配，且Client ID为唯一格式化字符串，不为null或0。

异常原因 #

• 外键类型处理错误：尽管迁移文件定义的类型一致，但Eloquent默认将关联外键按整数处理。由于Client的ID是字符串类型，当MeterReading表的client_id无法被转换为有效整数时，会被强制转为0，最终生成IN (0,0,...)的查询。部分MySQL版本在IN列表全为不存在的值时，会忽略该条件返回全部Client记录。
• 双向预加载冲突：两个模型都配置了protected $with自动预加载，可能触发循环预加载逻辑。在预加载client后，Client模型的自动预加载又会触发readings查询，过程中外键的类型转换问题被放大，导致错误的IN条件生成。
• 异常数据存在：MeterReading表中可能存在client_id为0或无效值的记录，这些数据在预加载时会被纳入外键集合，最终生成包含多个0的IN条件。

解决思路 #

• 修正模型主键类型配置：在Client模型中明确指定主键类型为字符串，关闭自增特性：

  protected $keyType = 'string';
  public $incrementing = false;
  

  同时在MeterReading的client关联中显式关联字段，确保类型匹配：

  public function client()
  {
      return $this->belongsTo(Client::class, 'client_id', 'id')->withTrashed();
  }
  

• 清理异常数据：查询并修正MeterReading表中client_id无效的记录：

  SELECT * FROM meter_readings WHERE client_id = '0' OR client_id IS NULL;
  

  对这些记录进行修正（关联正确的Client）或删除。
• 调整预加载策略：移除其中一个模型的自动预加载配置，改为手动按需预加载，避免循环预加载。例如去掉Client模型中protected $with里的readings，或者在查询时临时关闭自动预加载再手动指定：

  $readings= MeterReading::without('client')
      ->where('month', $this->month)
      ->where('year', $this->year)
      ->with(['client' => fn($query) => $query->withTrashed()])
      ->orderByDesc('meter_readings.created_at')->paginate($this->perPage);
  

• 验证查询生成逻辑：使用toSql()方法查看完整SQL语句，确认关联查询的外键条件是否正确：

  dd(MeterReading::where('month', $this->month)->where('year', $this->year)->with('client')->toSql());
  

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