Yii2控制器循环批量保存子区域数据仅存储最后一条记录问题

云上老周

2026-8-27

问题根因

你在嵌套循环外只实例化了1次AllowArea ActiveRecord模型，这是导致数据只存最后一条的核心原因：
Yii2的AR模型首次调用save()成功写入数据库后，会自动绑定数据库返回的主键值，同时将模型的isNewRecord属性标记为false。后续循环中再调用save()时，AR会判定当前模型是已存在的数据库记录，默认执行UPDATE更新操作而非INSERT新增操作；再加上你全程复用同一个模型对象，每次load()和属性赋值都是直接覆盖对象上的旧值，相当于全程反复更新同一条记录，最终自然只会留下每个主区域下最后一次赋值的子区域数据。

修复方法

核心调整逻辑如下：

把AllowArea模型的实例化逻辑移到内层循环内部，每生成一条子区域记录就创建一个全新的模型实例，保证每次调用save()时模型无主键值、isNewRecord为true，走新增逻辑。
不要在内层循环反复调用load()方法：user_id、salesman_code、创建人ID这类所有子区域记录共用的表单值，在外层统一提取一次即可，内层直接给新模型赋值，减少重复加载的性能损耗和属性覆盖风险。
批量写入场景建议开启数据库事务，避免中途报错导致部分数据入库、部分失败产生脏数据。

核心实现代码参考：

public function actionCreate()
{
    // 提前提取表单公共参数，无需循环内重复加载
    $post = Yii::$app->request->post();
    $formData = $post['AllowArea'] ?? [];
    $selectedCities = $formData['city_name'] ?? [];
    $bindUserId = $formData['user_id'] ?? null;
    $bindSalesmanCode = $formData['salesman_code'] ?? null;
    $creatorId = Yii::$app->user->id;
    $createTime = date('Y-m-d H:i:s');

    // 提前查询映射表，避免循环内重复查库
    $userMap = \app\models\User::toArrayList();
    $salesmanMap = \common\models\AllowArea::toArrayList();
    $bindUserName = $userMap[$bindUserId] ?? '';
    $bindSalesmanName = $salesmanMap[$bindSalesmanCode] ?? '';

    $db = Yii::$app->db;
    $transaction = $db->beginTransaction();
    try {
        foreach ($selectedCities as $cityName) {
            // 替换为你实际查询主区域下子区域的SQL逻辑
            $subAreas = $db->createCommand(
                'SELECT sub_code, sub_name FROM area_relation WHERE parent_city = :cityName',
                [':cityName' => $cityName]
            )->queryAll();

            foreach ($subAreas as $subArea) {
                // 关键：每次循环新建模型实例，保证走新增逻辑
                $model = new AllowArea();
                // 赋值子区域专属字段
                $model->sub_area_code = $subArea['sub_code'];
                $model->sub_area_name = $subArea['sub_name'];
                $model->parent_city_name = $cityName;
                // 赋值公共绑定字段
                $model->user_id = $bindUserId;
                $model->user_name = $bindUserName;
                $model->salesman_code = $bindSalesmanCode;
                $model->salesman_name = $bindSalesmanName;
                $model->create_by = $creatorId;
                $model->create_time = $createTime;

                if (!$model->save()) {
                    throw new \Exception('保存失败：' . array_values($model->getFirstErrors())[0]);
                }
            }
        }
        $transaction->commit();
        Yii::$app->session->setFlash('success', '区域配置保存成功');
        return $this->redirect(['index']);
    } catch (\Exception $e) {
        $transaction->rollBack();
        Yii::$app->session->setFlash('error', $e->getMessage());
    }

    // 原有渲染表单的逻辑
    $model = new AllowArea();
    return $this->render('create', [
        'model' => $model
    ]);
}

性能优化建议

如果单主区域下子区域量级较大，循环单条insert性能较差，可以在内层循环先收集所有待写入的字段数组，最后用$db->createCommand()->batchInsert()方法一次性批量写入，能大幅降低DB交互耗时。
表单多选的city_name字段建议加必填校验，避免传入空数组时跳过循环无任何数据写入。
可以在保存前先查询已存在的同子区域+同用户/同业务员的绑定记录，做去重判断，避免重复生成冗余数据。

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