第4章 客户端-客户端常见异常

1.无法从连接池获取到连接
连接池没有资源了，造成没有资源的原因主要有：

• 客户端 ：高并发下连接池设置过小，出现供不应求。
• 客户端 ：没有正确使用连接池，比如没有进行释放。
• 客户端 ：存在慢查询操作，这些慢查询持有的Jedis对象归还速度会比较慢，造成池子满了。
• 服务端：客户端是正常的，但是Redis服务端由于一些原因造成了客户端命令执行过程的阻塞，也会使得客户端抛出这种异常。
  2.客户端读写超时
  造成该异常的原因也有以下几种：
• 读写超时间设置得过短。
• 命令本身就比较慢。
• 客户端与服务端网络不正常。
• Redis自身发生阻塞。
  3.客户端连接超时
  造成该异常的原因也有以下几种：
  1）连接超时设置得过短，可以通过下面代码进行设置：

jedis.getClient().setConnectionTimeout(time);// 毫秒

2）Redis发生阻塞，造成tcp-backlog已满，造成新的连接失败。
3）客户端与服务端网络不正常。
4.客户端缓冲区异常
造成这个异常的原因可能有如下几种：
1）输出缓冲区满。例如将普通客户端的输出缓冲区设置为1M1M60：如果使用get命令获取一个bigkey（例如3M），就会出现这个异常。

config set client-output-buffer-limit "normal 1048576 1048576 60 slave 268435456 67108864 60 pubsub 33554432 8388608 60"

2）长时间闲置连接被服务端主动断开，上节已经详细分析了这个问题。
3）不正常并发读写：Jedis对象同时被多个线程并发操作，可能会出现上述异常。
5.Lua脚本正在执行
如果Redis当前正在执行Lua脚本，并且超过了lua-time-limit，此时Jedis调用Redis时，会收到下面的异常。可以使用script kill快速将脚本杀掉。如果当前Lua脚本正在执行写操作，那么script kill将不会生效。这时使用shutdown save。
6.Redis正在加载持久化文件
Jedis调用Redis时，如果Redis正在加载持久化文件，那么会收到下面的异常：

redis.clients.jedis.exceptions.JedisDataException: LOADING Redis is loading the dataset in memory

7.Redis使用的内存超过maxmemory配置
Jedis执行写操作时，如果Redis的使用内存大于maxmemory的设置，会收到下面的异常，此时应该调整maxmemory并找到造成内存增长的原因：

redis.clients.jedis.exceptions.JedisDataException: OOM command not allowed when used memory > 'maxmemory'.

8.客户端连接数过大
如果客户端连接数超过了maxclients，新申请的连接就会出现如下异常：

redis.clients.jedis.exceptions.JedisDataException: ERR max number of clients reached

此时新的客户端连接执行任何命令，返回结果都是如下：

127.0.0.1:6379> get hello
(error) ERR max number of clients reached

这个问题可能会比较棘手，因为此时无法执行Redis命令进行问题修复，一般来说可以从两个方面进行着手解决：

• 客户端：如果maxclients参数不是很小的话，应用方的客户端连接数基本不会超过maxclients，通常来看是由于应用方对于Redis客户端使用不当造成的。此时如果应用方是分布式结构的话，可以通过下线部分应用节点（例如占用连接较多的节点），使得Redis的连接数先降下来。从而让绝大部分节点可以正常运行，此时再通过查找程序bug或者调整maxclients进行问题的修复。
• 服务端：如果此时客户端无法处理，而当前Redis为高可用模式（例如Redis Sentinel和Redis Cluster），可以考虑将当前Redis做故障转移。此问题不存在确定的解决方式，但是无论从哪个方面进行处理，故障的快速恢复极为重要，当然更为重要的是找到问题的所在，否则一段时间后客户端连接数依然会超过maxclients。