TiDB 导入数据时报错 Error 8004 事务冲突怎么优化写入？

TiDB 导入数据出现 Error 8004 通常表示发生了写冲突（Write Conflict），多见于乐观事务模式下并发修改同一行数据。最推荐的优化方向是改用 TiDB Lightning 工具进行导入，或在会话级开启悲观事务模式，但需注意悲观事务可能增加锁等待延迟。

先说结论：Error 8004 是 TiDB 乐观事务下的写冲突报错，导入场景建议优先使用 TiDB Lightning 规避。

先确认：检查导入工具是原生 INSERT 还是 Lightning，确认事务模式是否为乐观。
先处理：切换为悲观事务模式 set tidb_txn_mode = 'pessimistic' 或改用 Lightning 本地导入。
再验证：观察监控面板中 tidb_kv_request_error 指标是否下降，确认导入任务不再中断。

命令速用版

如果必须使用原生 SQL 导入且无法更换工具，可以在导入会话中临时开启悲观事务模式，减少写冲突概率。

-- 在当前会话开启悲观事务模式
SET tidb_txn_mode = 'pessimistic';

-- 之后执行导入语句
INSERT INTO your_table VALUES ...;

如果是大批量数据导入，建议直接使用 TiDB Lightning 配置文件，无需手动处理事务模式。

为什么会这样

Error 8004 报错的根本原因是 TiDB 默认使用乐观事务，提交时检测到键值冲突会直接失败。

TiDB 默认开启乐观事务（Optimistic Transaction），事务执行期间不加锁，只在提交时检查冲突。当多个导入任务并发写入同一行数据或同一热点索引键时，后提交的事务会检测到数据已被修改，从而抛出写冲突错误。相比之下，悲观事务（Pessimistic Transaction）会在写入前先加锁，避免提交时的冲突报错，但会增加锁等待开销。

分步处理

按照以下顺序排查和处理，优先推荐更换导入工具，其次调整事务模式。

步骤 1：确认导入方式和错误日志

检查客户端报错信息，确认错误码是否为 8004 且伴随 Write Conflict 字样。如果是使用 mysqldump 或自定义脚本导入，记录并发线程数。

步骤 2：评估是否可切换 TiDB Lightning

对于全量数据导入，TiDB Lightning 是官方推荐工具，其底层机制绕过 SQL 层直接导入 KV 数据，能有效避免事务冲突。

操作动作：下载 TiDB Lightning，配置 toml 文件，设置 backend = "local" 或 "tidb" 模式启动导入。

步骤 3：临时切换悲观事务模式

如果必须使用 SQL 导入，在导入脚本连接数据库后，立即执行事务模式切换命令。

操作动作：在执行 INSERT 前运行 SET tidb_txn_mode = 'pessimistic';。

风险边界：TiDB v4.0 及以上版本支持悲观事务，旧版本不支持此参数。

步骤 4：检查热点行问题

如果冲突集中在自增主键或时间索引，考虑打散热点。

操作动作：使用 SHARD_ROW_ID_BITS 参数打散行 ID 热点，或避免使用单调递增的时间戳作为索引。

怎么验证是否生效

通过监控指标和日志确认冲突错误是否减少，导入任务是否完成。

检查命令：在 TiDB 监控面板（Grafana）中查看 TiDB-KV-Request-Error 面板，确认 write conflict 相关计数不再增长。

日志位置：查看 TiDB Server 日志，搜索 write conflict 关键字，确认报错频率降低。

状态判断：导入任务状态显示为 Completed 或 Success，且无回滚重试日志。

常见坑

处理 Error 8004 时容易忽略配置细节和版本兼容性，导致问题复发。

忽略事务大小限制：即使开启悲观事务，单个事务过大仍可能触发 txn too large 错误，建议分批提交。
版本不兼容：TiDB v4.0 之前版本不支持悲观事务，强行设置参数无效，需升级集群或更换导入方式。
热点未消除：如果主键是单调递增的自增 ID，高并发导入必然冲突，需使用随机 ID 或预分配区间。
客户端重连失效：会话级设置 tidb_txn_mode 仅在当前连接生效，客户端重连后需重新设置。

常见问题

Error 8004 会导致数据不一致吗？

不会，事务冲突会触发回滚，已提交的数据保持一致。

TiDB 的事务机制保证原子性，报错时该事务内的所有修改都会回滚，不会产生脏数据，但需要应用程序重试。

开启悲观事务会影响导入速度吗？

会，悲观事务加锁机制可能降低高并发下的吞吐量。

悲观事务需要等待锁资源，在高冲突场景下虽然减少了报错重试，但单次写入延迟可能增加，整体耗时需实际测试验证。

TiDB Lightning 导入还会报 8004 吗？

通常不会，Lightning 本地模式 bypass 了 SQL 事务层。

TiDB Lightning 在本地模式（local backend）下直接排序和导入 KV 数据，不经过 TiDB SQL 层的事务冲突检测，因此极少出现此类错误。

参考来源

TiDB 官方文档 - 事务概述：https://docs.pingcap.com/zh/tidb/stable/transaction-overview
TiDB 官方文档 - TiDB Lightning 概述：https://docs.pingcap.com/zh/tidb/stable/tidb-lightning-overview
TiDB 官方文档 - 事务常见问题：https://docs.pingcap.com/zh/tidb/stable/transaction-faq