错误码与故障诊断

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

错误码

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

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

故障诊断

参见故障诊断文档以及 FAQ