Laravel 8批量更新实体异常：所有实体字段值被设为最后索引的问题

问题根源 #

你遇到的问题核心是模型主键设置错误：将非唯一的field1设为模型主键后，Laravel执行update()时会以field1作为唯一更新条件，导致每次更新都会修改所有field1=1的实体，最终所有记录的field2被最后一次循环的index=4覆盖。

解决方案 #

1. 修正模型主键配置（优先推荐） #

如果你的数据库表存在真正的唯一主键（比如自增id字段），直接在SomeModel中修正主键设置：

class SomeModel extends Model
{
    protected $primaryKey = 'id'; // 改为表的实际唯一主键
    public $incrementing = true; // 如果是自增主键，保持开启
    // ...其他配置
}

修正后，原有的遍历更新代码会正常工作，因为Laravel会用唯一的主键生成精准的更新条件，不会批量修改记录。

2. 无单独主键时，手动指定唯一更新条件 #

如果表确实没有单独的唯一主键，只能依赖field1与fieldX/fieldY/fieldZ的组合唯一规则，那么需要在更新时手动拼接唯一查询条件，避免使用模型的默认update()方法：

$entities = SomeModel::where('field1', 1)->get();
$entities->each(function ($entity, $index) {
    // 根据实际的唯一组合规则选择条件，比如field1 + fieldX
    SomeModel::where('field1', $entity->field1)
        ->where('fieldX', $entity->fieldX)
        ->update(['field2' => $index]);
});

这种方式会确保每次更新只针对当前唯一的实体，不会影响其他同field1的记录。

3. 重写模型的主键相关方法（进阶方案） #

如果需要长期支持复合主键逻辑，可以重写模型的主键相关方法，让Laravel识别复合键作为更新条件（注意：Laravel原生不支持复合主键，此方案需自行维护）：

class SomeModel extends Model
{
    protected $primaryKey = ['field1', 'fieldX']; // 复合主键数组
    public $incrementing = false; // 关闭自增

    // 重写获取主键名称的方法
    public function getKeyName()
    {
        return $this->primaryKey;
    }

    // 重写获取主键值的方法
    public function getKey()
    {
        return collect($this->primaryKey)->map(function ($key) {
            return $this->attributes[$key];
        })->toArray();
    }

    // 重写更新逻辑，使用复合键作为where条件
    protected function setKeysForSaveQuery($query)
    {
        foreach ($this->primaryKey as $key) {
            $query->where($key, $this->getAttribute($key));
        }
        return $query;
    }
}

重写后，模型的update()和save()方法会自动使用复合键作为查询条件，原有的遍历代码即可正常运行。

内容的提问来源于stack exchange，提问作者Agustín Pérez Leiras