Laravel使用replicate克隆数据行时出现insert关联select SQL错误

错误原因 #

该报错并非replicate方法本身的缺陷，而是你的Enrollment模型在保存流程中嵌入了返回多条记录的子查询，触发了数据库 cardinality 校验规则。

排查与修复步骤 #

• 排查模型事件逻辑
  检查Enrollment模型的boot方法中注册的saving、creating等前置事件，确认事件回调中的赋值逻辑没有直接返回查询构造器或者集合，所有赋值给字段的值都应该是单个标量结果。常见错误写法示例：

  // 错误：没有调用first()/value()，直接把查询构造器赋值给字段，会生成子查询
  static::creating(function ($model) {
      $model->effective_date = \App\Term::where('id', $model->term_id)->select('start_date');
  });
  

  修正为取单个值即可：

  static::creating(function ($model) {
      $model->effective_date = \App\Term::where('id', $model->term_id)->value('start_date');
  });
  

• 排除模型虚拟字段
  检查模型的$appends属性，确认你没有把虚拟追加字段写入数据库表。调用replicate时可以传入需要排除的字段数组，过滤不需要克隆的属性：

  // 排除不需要的字段，比如主键、虚拟属性、软删除字段等
  $new_enrollment = $enrollment->replicate(['id', 'deleted_at', 'custom_virtual_field']);
  

• 临时关闭事件定位问题
  可以将save()方法替换为saveQuietly()，跳过所有模型事件触发，如果替换后保存成功，即可确定问题出在模型事件逻辑中，再针对性排查对应代码即可。
• 排查全局作用域逻辑
  检查模型中是否注册了全局作用域，给某个字段默认绑定了返回多条结果的子查询，调整作用域逻辑保证子查询仅返回单个值即可。

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