使用mysqli_multi_query批量插入时SQL语法错误排查求助

Hey Sethu，咱们一步步拆解你遇到的这几个问题，帮你彻底解决批量插入考勤数据的问题～

先解决两个核心语法错误 #

Error 1：多个INSERT语句未正确分隔 #

你的第一版代码里，循环拼接$query时，每个INSERT语句之间没有加分号（;）。MySQL会把所有拼接的INSERT当成一条不完整的SQL语句，自然会报错。比如你拼接后的SQL会变成：

INSERT INTO ... VALUES (...) INSERT INTO ... VALUES (...)

MySQL根本分不清第一个INSERT在哪里结束，第二个在哪里开始，必然触发语法错误。

Error 2：字段名错误使用单引号 #

第二版代码里你给字段名加了单引号'attendance_date'，这是典型的语法错误——MySQL里字段名如果需要转义（比如和关键字重名）应该用反引号（`），如果字段名不是关键字甚至可以直接写；而单引号是用来包裹字符串值的，不是字段名的合法包裹符，MySQL会把带单引号的字段名当成普通字符串，直接报错。

再解决「偶尔执行成功却无数据写入」的隐藏坑 #

除了上面的语法问题，还有几个容易忽略的点会导致这个诡异现象：

• $query变量未初始化：第二版代码里你没有写$query = '';，如果PHP脚本执行有残留的变量内容（比如会话缓存、之前的执行残留），会导致拼接的SQL混乱，可能执行了无效语句。
• mysqli_multi_query的结果未正确处理：这个函数执行多语句后，必须循环处理所有结果集，否则会导致数据库连接的状态异常，看起来执行成功但实际后续语句没被执行。
• 数组索引安全问题：如果attendance_present_absent数组的元素数量和其他数组不一致，会导致未定义索引警告，进而破坏SQL拼接。

修正后的完整可运行代码 #

我把你的代码做了全面修正，解决了所有问题：

include("../includes/db.php");
if(!empty($_POST)) {
    // 初始化变量，避免未定义的问题
    $attendance_date = $_POST['attendance_date'] ?? '';
    $attendance_class_id = $_POST['attendance_class_id'] ?? [];
    $attendance_section_id = $_POST['attendance_section_id'] ?? [];
    $attendance_student_id = $_POST['attendance_student_id'] ?? [];
    $attendance_present_absent = $_POST['attendance_present_absent'] ?? [];

    $query = ''; // 必须初始化，避免残留内容干扰
    $studentCount = count($attendance_student_id);
    for($count = 0; $count < $studentCount; $count++) {
        // 转义所有变量，避免SQL注入
        $attendance_date_now = mysqli_real_escape_string($connection, $attendance_date);
        $attendance_class_id_now = mysqli_real_escape_string($connection, $attendance_class_id[$count]);
        $attendance_section_id_now = mysqli_real_escape_string($connection, $attendance_section_id[$count]);
        $attendance_student_id_now = mysqli_real_escape_string($connection, $attendance_student_id[$count]);
        // 处理可能不存在的出勤状态值
        $attendance_present_absent_now = isset($attendance_present_absent[$count]) 
            ? mysqli_real_escape_string($connection, $attendance_present_absent[$count]) 
            : '';

        // 字段名不用单引号，每个INSERT结尾加分号分隔
        $query .= "INSERT INTO student_attendance (attendance_date, attendance_class_id, attendance_section_id, attendance_student_id, attendance_present_absent) ";
        $query .= "VALUES ('{$attendance_date_now}', '{$attendance_class_id_now}', '{$attendance_section_id_now}', '{$attendance_student_id_now}', '{$attendance_present_absent_now}'); ";
    }

    // 执行多语句查询并处理结果
    if(mysqli_multi_query($connection, $query)) {
        // 必须循环处理所有结果集，否则会导致连接状态异常
        do {
            if($result = mysqli_store_result($connection)) {
                mysqli_free_result($result);
            }
        } while(mysqli_next_result($connection));
        
        echo "考勤数据批量插入成功！";
    } else {
        die("Error: " . mysqli_error($connection));
    }
}

额外的优化建议 #

• 优先使用预处理语句（prepared statements）代替直接拼接SQL，比如用mysqli_prepare配合bind_param，这样更安全（避免SQL注入），也不用手动转义变量，批量插入效率也更高。
• 可以在循环里先验证每个学生的数据是否有效（比如attendance_student_id[$count]是否不为空），避免插入无效数据。
• 可以用事务包裹批量插入操作，确保要么全部插入成功，要么全部回滚，避免部分数据插入的情况。

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