php 8.6批量导入mysql记录时,若业务允许跳过重复键、保留其他成功行,可在innodb事务内为每一行建立保存点,只对错误码1062回滚该行,其他数据库错误仍回滚整批。保存点与“整批失败全部撤销”是不同策略,必须先明确部分成功符合业务要求。

MySQLi官方手册中的SAVEPOINT方法
先创建专用测试表
CREATE TABLE demo_import ( id INT PRIMARY KEY, label VARCHAR(100) NOT NULL ) ENGINE=InnoDB CHARACTER SET utf8mb4;
建表DDL在事务外执行。示例使用固定表名和固定保存点名称,不将外部输入拼进SQL标识符。连接账号、数据库和字符集应先按自己的测试环境配置。
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', getenv('DB_USER'), getenv('DB_PASSWORD'), 'app');
$db->set_charset('utf8mb4');
$rows = [[1, '第一条'], [1, '重复'], [2, '第二条']];
$stmt = $db->prepare('INSERT INTO demo_import (id, label) VALUES (?, ?)');
$saved = $skipped = 0;
$db->begin_transaction();
try {
foreach ($rows as [$id, $label]) {
$db->savepoint('row_item');
try {
$stmt->bind_param('is', $id, $label);
$stmt->execute();
$saved++;
} catch (mysqli_sql_exception $e) {
if ($e->getCode() !== 1062) throw $e;
$db->query('ROLLBACK TO SAVEPOINT row_item');
$skipped++;
}
$db->release_savepoint('row_item');
}
$db->commit();
} catch (Throwable $e) {
$db->rollback();
throw $e;
} finally { $stmt->close(); }
echo json_encode(['saved' => $saved, 'duplicate_keys' => $skipped], JSON_THROW_ON_ERROR), PHP_EOL;
官方rollback签名和当前事务回滚说明
不能把所有异常都当重复数据
连接中断、权限不足、死锁或字段校验失败不属于1062,应交给外层终止并回滚。rollback()的可选name参数不是“回滚到这个保存点”,因此这里使用固定的ROLLBACK TO SAVEPOINT语句。事务成功提交前,统计只是本次执行过程中的暂存结果,不应提前通报已入库。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
在空表上运行示例,应最终保留id为1和2的两行,重复id那行被跳过;再次运行时结果会受已有数据影响。数据规模较大时,还需按锁持有时间和业务恢复策略选择批次边界,不能无限延长一个事务。


















