Laravel hasMany关联复合主键中间表返回空数组问题排查

以下是最常见的问题原因，按优先级排序：

• 1. 中间表模型主键配置错误
  你的account_receivable_details是复合主键表，AccountReceivableDetail模型必须显式指定复合主键，否则Laravel默认会查找单主键id，生成的关联查询SQL会用错误的字段匹配，导致查不到数据：

  class AccountReceivableDetail extends Model
  {
      // 显式指定复合主键
      protected $primaryKey = ['account_receivable_id', 'order_id'];
      public $incrementing = false;
      // 如果主键是字符串类型，额外加这行：protected $keyType = 'string';
  }
  

• 2. 关联字段类型/值不匹配
  检查account_receivables和account_receivable_details两张表的account_receivable_id字段属性：
  包括字段类型（比如主表是字符串、中间表是整型）、字符集/排序规则、值的大小写差异，都会导致匹配失败。
• 3. 中间表模型表名配置错误
  Laravel默认会将模型名转为蛇形复数作为表名，如果你的AccountReceivableDetail模型对应的表名不是account_receivable_details，需要显式指定：

  protected $table = 'account_receivable_details';
  

• 4. 软删除/全局作用域过滤
  如果AccountReceivableDetail模型启用了软删除，数据库里匹配的数据如果deleted_at不为空会被自动过滤；如果模型定义了租户、状态类的全局作用域，也会默认加查询条件过滤数据，可以临时加方法验证：

  // 临时关闭软删除、全局作用域验证
  return $this->hasMany(AccountReceivableDetail::class, 'account_receivable_id', 'account_receivable_id')
              ->withTrashed()
              ->withoutGlobalScopes();
  

快速定位方法 #

开启SQL日志打印关联查询的原生SQL，直接到数据库执行即可快速定位问题：

public function getRiwayatById(Request $request, $id){
    \DB::enableQueryLog();
    $riwayat = AccountReceivable::where('account_receivable_id', $id)
                                ->with('accountReceivableDetail')
                                ->first();
    // 打印执行的所有SQL和绑定参数
    dd(\DB::getQueryLog());
    return $riwayat;
}

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