Yii2高级版：GridView考勤数据无法保存至数据库的问题排查

核心问题分析 #

当前代码存在多个关键问题导致数据无法保存：

• 视图未用表单包裹复选框，无法提交POST数据
• CheckboxColumn未指定正确name属性，控制器无法获取选中的学生ID
• MATRICULA字段赋值错误（传入模型对象而非数值字段）
• 保存按钮使用GET请求，不符合表单提交规范

具体修复步骤 #

1. 修复视图代码（index.php） #

用表单包裹GridView和保存按钮，同时指定CheckboxColumn的name属性：

$this->title = 'Asistencias';
$this->params['breadcrumbs'][] = $this->title;
?>
<div class="asistencia-index">

    <h1><?= Html::encode($this->title) ?></h1>
    <?php Html::beginForm(['create', 'criterio' => $criterio], 'post'); ?>
    <?= GridView::widget([
        'dataProvider' => $dataProvider,
        'columns' => [
            ['class' => 'yii\grid\SerialColumn'],
            'alumno',
            'nombres',
            'apellidos',
            [  
                'class' => 'yii\grid\CheckboxColumn',
                'name' => 'alumno[]', // 指定批量提交的name
                'checkboxOptions' => function($model, $key, $index, $column) {
                    return [
                        'checked' => true,
                        'value' => $model->alumno // 确保提交值为学生ID
                    ];
                }
            ],
        ],
    ]); ?>
    <?= Html::submitButton('Guardar', ['class' => 'btn btn-success']) ?>
    <?php Html::endForm(); ?>
</div>

2. 修复控制器create方法 #

修正MATRICULA赋值逻辑，同时处理save返回值并添加错误提示：

public function actionCreate()
{
    $request = Yii::$app->request;
    $alumnos = $request->post('alumno', []);
    $criterio = $request->get('criterio');
    
    $fecha = date('Y-m-d');
    $successCount = 0;
    
    foreach ($alumnos as $alumno) {
        $asistencia = new Asistencia();
        $asistencia->ALUMNO = $alumno;
        
        // 获取学籍记录的数值字段
        $matricula = Matricula::findOne(['ALUMNO' => $alumno]);
        if (!$matricula) {
            Yii::$app->session->addFlash('error', "学生 $alumno 未找到对应学籍记录");
            continue;
        }
        $asistencia->MATRICULA = $matricula->NUMEROMATRICULA;
        
        $asistencia->fecha = $fecha;
        $asistencia->asiste = $request->post("asistencia_$alumno", 'no');
        
        // 直接检查save返回值（包含validate逻辑）
        if ($asistencia->save()) {
            $successCount++;
        } else {
            $errors = implode(', ', $asistencia->getFirstErrors());
            Yii::$app->session->addFlash('error', "保存学生 $alumno 考勤失败：$errors");
        }
    }
    
    // 根据实际保存情况给出提示
    if ($successCount > 0) {
        Yii::$app->session->setFlash('success', "成功保存 $successCount 条考勤记录");
    }
    
    return $this->redirect(['index', 'criterio' => $criterio]);
}

3. 验证模型规则（Asistencia.php） #

确认模型规则与数据库字段匹配：

• MATRICULA为integer类型，需传入数值而非模型对象
• 唯一约束['ALUMNO', 'MATRICULA', 'fecha']会阻止重复数据，需在控制器中捕获并提示

额外注意事项 #

• 开启Yii调试模式（YII_DEBUG=true），查看SQL执行日志确认插入语句是否执行
• 检查数据库asistencia表的权限，确保Web用户拥有插入权限
• 若需记录未出勤学生，需遍历课程下所有学生，而非仅选中的复选框

内容的提问来源于stack exchange，提问作者Saúl Velecela