错误码与故障诊断

本篇文档描述在使用 TiDB 过程中会遇到的问题以及解决方法。

错误码

TiDB 兼容 MySQL 的错误码,在大多数情况下,返回和 MySQL 一样的错误码。另外还有一些特有的错误码:

错误码说明
8001请求使用的内存超过 TiDB 内存使用的阈值限制
8002带有 SELECT FOR UPDATE 语句的事务,在遇到写入冲突时,为保证一致性无法进行重试,事务将进行回滚并返回该错误
8003ADMIN CHECK TABLE 命令在遇到行数据跟索引不一致的时候返回该错误
8004单个事务过大,原因及解决方法请参考这里
8005事务在 TiDB 中遇到了写入冲突,原因及解决方法请参考这里
9001请求 PD 超时,请检查 PD Server 状态/监控/日志以及 TiDB Server 与 PD Server 之间的网络
9002请求 TiKV 超时,请检查 TiKV Server 状态/监控/日志以及 TiDB Server 与 TiKV Server 之间的网络
9003TiKV 操作繁忙,一般出现在数据库负载比较高时,请检查 TiKV Server 状态/监控/日志
9004当数据库上承载的业务存在大量的事务冲突时,会遇到这种错误,请检查业务代码
9005某个 Raft Group 不可用,如副本数目不足,出现在 TiKV 比较繁忙或者是 TiKV 节点停机的时候,请检查 TiKV Server 状态/监控/日志
9006GC Life Time 间隔时间过短,长事务本应读到的数据可能被清理了,应增加 GC Life Time
9007事务在 TiKV 中遇到了写入冲突,原因及解决方法请参考这里

故障诊断

参见故障诊断文档以及 FAQ