Jedis常见异常汇总

超、凢脫俗 2022-03-22 12:13 1107阅读 0赞

转自：[https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW\#cc1][https_yq.aliyun.com_articles_236384_spm_a2c4e.11155435.0.0.e21e2612uQAVoW_cc1]

Jedis虽然使用起来比较简单，但是如果不能根据使用场景设置合理的参数(例如连接池参数)，不合理的使用一些功能(例如Lua和事务)也会产生很多问题，本文对这些问题逐个说明：

### 详细目录： ###

*  [一、redis.clients.jedis.exceptions.JedisConnectionException: Could not get a resource from the pool][https_yq.aliyun.com_articles_236384_spm_a2c4e.11155435.0.0.e21e2612uQAVoW_cc1]
 *  [二、redis.clients.jedis.exceptions.JedisConnectionException: Unexpected end of stream][redis.clients.jedis.exceptions.JedisConnectionException_ Unexpected end of stream]
 *  [三、redis.clients.jedis.exceptions.JedisDataException: ERR illegal address][redis.clients.jedis.exceptions.JedisDataException_ ERR illegal address]
 *  [四、redis.clients.jedis.exceptions.JedisDataException: ERR max number of clients reached][redis.clients.jedis.exceptions.JedisDataException_ ERR max number of clients reached]
 *  [五、redis.clients.jedis.exceptions.JedisConnectionException: java.net.SocketTimeoutException: Read timed out][redis.clients.jedis.exceptions.JedisConnectionException_ java.net.SocketTimeoutException_ Read timed out]
 *  [六、redis.clients.jedis.exceptions.JedisDataException: NOAUTH Authentication required][redis.clients.jedis.exceptions.JedisDataException_ NOAUTH Authentication required]
 *  [七、redis.clients.jedis.exceptions.JedisDataException: EXECABORT Transaction discarded because of previous errors][redis.clients.jedis.exceptions.JedisDataException_ EXECABORT Transaction discarded because of previous errors]
 *  [八、java.lang.ClassCastException: java.lang.Long cannot be cast to java.util.List][java.lang.ClassCastException_ java.lang.Long cannot be cast to java.util.List]
 *  [九、redis.clients.jedis.exceptions.JedisDataException: WRONGTYPE Operation against a key holding the wrong kind of value][redis.clients.jedis.exceptions.JedisDataException_ WRONGTYPE Operation against a key holding the wrong kind of value]
 *  [十、redis.clients.jedis.exceptions.JedisDataException: OOM command not allowed when used memory > 'maxmemory'][redis.clients.jedis.exceptions.JedisDataException_ OOM command not allowed when used memory _ _maxmemory]
 *  [十一、redis.clients.jedis.exceptions.JedisDataException: LOADING Redis is loading the dataset in memory][redis.clients.jedis.exceptions.JedisDataException_ LOADING Redis is loading the dataset in memory]
 *  [十二、redis.clients.jedis.exceptions.JedisDataException: BUSY Redis is busy running a script. You can only call SCRIPT KILL or SHUTDOWN NOSAVE.][redis.clients.jedis.exceptions.JedisDataException_ BUSY Redis is busy running a script. You can only call SCRIPT KILL or SHUTDOWN NOSAVE.]
 *  [十三、redis.clients.jedis.exceptions.JedisConnectionException: java.net.SocketTimeoutException: connect timed out][redis.clients.jedis.exceptions.JedisConnectionException_ java.net.SocketTimeoutException_ connect timed out]
 *  [十四、UNKILLABLE Sorry the script already executed write commands against the dataset. You can either wait the script termination or kill the server in a hard way using the SHUTDOWN NOSAVE command.][UNKILLABLE Sorry the script already executed write commands against the dataset. You can either wait the script termination or kill the server in a hard way using the SHUTDOWN NOSAVE command.]
 *  [十五、java.lang.NoClassDefFoundError][java.lang.NoClassDefFoundError]
 *  [十六、redis.clients.jedis.exceptions.JedisDataException: ERR unknown command][redis.clients.jedis.exceptions.JedisDataException_ ERR unknown command]
 *  [十七、redis.clients.jedis.exceptions.JedisDataException: Please close pipeline or multi block before calling this method.][redis.clients.jedis.exceptions.JedisDataException_ Please close pipeline or multi block before calling this method.]
 *  [十八、redis.clients.jedis.exceptions.JedisDataException: ERR command role not support for normal user.][redis.clients.jedis.exceptions.JedisDataException_ ERR command role not support for normal user.]

### 一.无法从连接池获取到Jedis连接 ###

1.异常堆栈

(1) 连接池参数blockWhenExhausted = true(默认)

如果连接池没有可用Jedis连接，会等待maxWaitMillis(毫秒)，依然没有获取到可用Jedis连接，会抛出如下异常：

redis.clients.jedis.exceptions.JedisConnectionException: Could not get a resource from the pool
        …
    Caused by: java.util.NoSuchElementException: Timeout waiting for idle object
        at org.apache.commons.pool2.impl.GenericObjectPool.borrowObject(GenericObjectPool.java:449)

(2) 连接池参数blockWhenExhausted = false

设置如果连接池没有可用Jedis连接，立即抛出异常：

redis.clients.jedis.exceptions.JedisConnectionException: Could not get a resource from the pool
        …
    Caused by: java.util.NoSuchElementException: Pool exhausted
        at org.apache.commons.pool2.impl.GenericObjectPool.borrowObject(GenericObjectPool.java:464)

2.异常描述

![1][]

上述异常是客户端没有从连接池(最大maxTotal个)拿到可用Jedis连接造成的，具体可能有如下原因：

(1) 连接泄露 (**较为常见**)

JedisPool默认的maxTotal=8，下面的代码从JedisPool中借了8次Jedis，但是没有归还，当第9次(jedisPool.getResource().ping())

GenericObjectPoolConfig poolConfig = new GenericObjectPoolConfig();
    JedisPool jedisPool = new JedisPool(poolConfig, "127.0.0.1", 6379);
    //向JedisPool借用8次连接，但是没有执行归还操作。
    for (int i = 0; i < 8; i++) {
        Jedis jedis = null;
        try {
            jedis = jedisPool.getResource();
            jedis.ping();
        } catch (Exception e) {
            logger.error(e.getMessage(), e);
        }
    }
    jedisPool.getResource().ping();

所以推荐使用的代码规范是：

执行命令如下：
    Jedis jedis = null;
    try {
        jedis = jedisPool.getResource();
        //具体的命令
        jedis.executeCommand()
    } catch (Exception e) {
        //如果命令有key最好把key也在错误日志打印出来，对于集群版来说通过key可以帮助定位到具体节点。
        logger.error(e.getMessage(), e);
    } finally {
        //注意这里不是关闭连接，在JedisPool模式下，Jedis会被归还给资源池。
        if (jedis != null) 
            jedis.close();
    }

(2) 业务并发量大，maxTotal确实设置小了。

举个例子：

*  一次命令时间（borrow|return resource + Jedis执行命令(含网络) ）的平均耗时约为1ms，一个连接的QPS大约是1000
 *  业务期望的QPS是50000

那么理论上需要的资源池大小是50000 / 1000 = 50个，实际maxTotal可以根据理论值进行微调。

(3) Jedis连接还的太慢

例如Redis发生了阻塞(例如慢查询等原因)，所有连接在超时时间范围内等待，并发量较大时，会造成连接池资源不足。

(4) 其他问题

例如丢包、DNS、客户端TCP参数配置，具体可以参考：[Jedis介绍及常见问题分析][Jedis]

3.解决方法：

可以看到这个问题稍微复杂一些，不要被异常的表象所迷惑，简单地认为连接池不够就盲目加大maxTotal，要具体问题具体分析。

连接池参数优化可以参考：[JedisPool资源池优化][JedisPool]

4.处理人

客户先确认，如解决不了，需要借助工单解决

**还有一种情况是**：从池子里拿连接，由于没有空闲连接，需要重新生成一个Jedis连接，但是连接被拒绝：

redis.clients.jedis.exceptions.JedisConnectionException: Could not get a resource from the pool
        at redis.clients.util.Pool.getResource(Pool.java:50)
        at redis.clients.jedis.JedisPool.getResource(JedisPool.java:99)
        at TestAdmin.main(TestAdmin.java:14)
    Caused by: redis.clients.jedis.exceptions.JedisConnectionException: java.net.ConnectException: Connection refused
        at redis.clients.jedis.Connection.connect(Connection.java:164)
        at redis.clients.jedis.BinaryClient.connect(BinaryClient.java:80)
        at redis.clients.jedis.BinaryJedis.connect(BinaryJedis.java:1676)
        at redis.clients.jedis.JedisFactory.makeObject(JedisFactory.java:87)
        at org.apache.commons.pool2.impl.GenericObjectPool.create(GenericObjectPool.java:861)
        at org.apache.commons.pool2.impl.GenericObjectPool.borrowObject(GenericObjectPool.java:435)
        at org.apache.commons.pool2.impl.GenericObjectPool.borrowObject(GenericObjectPool.java:363)
        at redis.clients.util.Pool.getResource(Pool.java:48)
        ... 2 more
    Caused by: java.net.ConnectException: Connection refused
        at java.net.PlainSocketImpl.socketConnect(Native Method)
        at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:339)
        at java.net.AbstractPlainSocketImpl.connectToAddress(AbstractPlainSocketImpl.java:200)
        at java.net.AbstractPlainSocketImpl.connect(AbstractPlainSocketImpl.java:182)
        at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:392)
        at java.net.Socket.connect(Socket.java:579)
        at redis.clients.jedis.Connection.connect(Connection.java:158)
        ... 9 more

可以从at redis.clients.jedis.Connection.connect(Connection.java:158)看到实际是一个Socket连接：

socket.setSoLinger(true, 0); // Control calls close () method,
            // the underlying socket is closed
            // immediately
            // <-@wjw_add
    
    158:  socket.connect(new InetSocketAddress(host, port), connectionTimeout);

**一般这种需要检查Redis的域名配置是否正确，排查该段时间网络是否正常**

### 二、客户端缓冲区异常 ###

1.异常堆栈

redis.clients.jedis.exceptions.JedisConnectionException: Unexpected end of stream.
        at redis.clients.util.RedisInputStream.ensureFill(RedisInputStream.java:199)
        at redis.clients.util.RedisInputStream.readByte(RedisInputStream.java:40)
        at redis.clients.jedis.Protocol.process(Protocol.java:151)
    ......

2.异常描述：

这个异常是客户端缓冲区异常，产生这个问题可能有三个原因：

(1) 常见原因：多个线程使用一个Jedis连接，正常的情况是一个线程使用一个Jedis连接，可以使用JedisPool管理Jedis连接，实现线程安全，防止出现这种情况，例如下面代码中两个线程用了一个Jedis连接：

new Thread(new Runnable() {
    
        public void run() {
            for (int i = 0; i < 100; i++) {
                jedis.get("hello");
            }
        }
    }).start();
    
    new Thread(new Runnable() {
    
        public void run() {
            for (int i = 0; i < 100; i++) {
                jedis.hget("haskey", "f");
            }
        }
    }).start();

(2) 客户端缓冲区满了

Redis有三种客户端缓冲区：

*  普通客户端缓冲区(normal)：用于接受普通的命令，例如get、set、mset、hgetall、zrange等
 *  slave客户端缓冲区(slave)：用于同步master节点的写命令，完成复制。
 *  发布订阅缓冲区(pubsub)：pubsub不是普通的命令，因此有单独的缓冲区。

![客户端缓冲区][9dac508bb5669a6e690bdbbedf6e98c82581e1e1.png]

Redis的客户端缓冲区配置具体格式是：

client-output-buffer-limit <class> <hard limit> <soft limit> <soft seconds>

(a) class: 客户端类型：(a) normal、(b) slave、(c) pubsub

(b) hard limit: 如果客户端使用的输出缓冲区大于hard limit，客户端会被立即关闭。

例如下面是一份Redis缓冲区的配置，所以当条件满足时，客户端连接会被关闭，就会出现Unexpected end of stream。

redis> config get client-output-buffer-limit
    1) "client-output-buffer-limit"
    2) "normal 524288000 0 0 slave 2147483648 536870912 480 pubsub 33554432 8388608 60"

(3) 长时间闲置连接被服务端主动断开，可以查询timeout配置的设置以及自身连接池配置是否需要做空闲检测。

3.解决方法和处理人：

**客户**：排查自身代码是否使用JedisPool管理Jedis连接，是否存在并发操作Jedis的情况。

**工单**: 排查(2)(3)，阿里云Redis中timeout=0，也就是不会主动关闭空闲连接，缓冲区设置为0 0 0 也就是不会对客户端缓冲区进行限制，一般不会有问题

### 三、非法客户端地址 （阿里云Redis提供客户端白名单功能） ###

1.异常堆栈

Caused by: redis.clients.jedis.exceptions.JedisDataException: ERR illegal address
        at redis.clients.jedis.Protocol.processError(Protocol.java:117)
        at redis.clients.jedis.Protocol.process(Protocol.java:151)
        at redis.clients.jedis.Protocol.read(Protocol.java:205)
        ......

2.异常描述：

Redis实例配置了白名单，但当前访问Redis的客户端(IP)不在白名单中。

3.解决方法：

添加该客户端(IP)的白名单

4.处理人

客户或者工单都可以

### 四、客户端连接数达到最大值 ###

1.异常堆栈

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

2.异常描述：

如果客户端连接数超过了Redis实例配置的最大maxclients

3.解决方法：

提工单帮助临时调大最大连接数，并让客户找到连接数暴涨的原因(因为上述调整只是临时调整)，

4.处理人

*  工单：临时调整最大连接数，协助定位问题
 *  客户：定位自身问题(可以定位连接最多的客户端)，找到问题原因（例如连接池配置等）

### 五、客户端读写超时 ###

1.异常堆栈

redis.clients.jedis.exceptions.JedisConnectionException: java.net.SocketTimeoutException: Read timed out

2.异常描述：

该问题原因可能有如下几种：  
(1) 读写超时设置的过短。  
(2) 有慢查询或者Redis发生阻塞。  
(3) 网络不稳定。

3.解决方法：

客户提供读写超时时间，提交工单定位相关原因

4.处理人：

工单。

### 六、密码相关的异常 ###

1.异常堆栈

Redis设置了密码，客户端请求没传密码：

Exception in thread "main" redis.clients.jedis.exceptions.JedisDataException: NOAUTH Authentication required.
         at redis.clients.jedis.Protocol.processError(Protocol.java:127)
         at redis.clients.jedis.Protocol.process(Protocol.java:161)
         at redis.clients.jedis.Protocol.read(Protocol.java:215)

Redis没有设置密码，客户端传了密码：

Exception in thread "main" redis.clients.jedis.exceptions.JedisDataException: ERR Client sent AUTH, but no password is set
         at redis.clients.jedis.Protocol.processError(Protocol.java:127)
         at redis.clients.jedis.Protocol.process(Protocol.java:161)
         at redis.clients.jedis.Protocol.read(Protocol.java:215)

客户端传了错误的密码：

redis.clients.jedis.exceptions.JedisDataException: ERR invalid password
        at redis.clients.jedis.Protocol.processError(Protocol.java:117)
        at redis.clients.jedis.Protocol.process(Protocol.java:151)
        at redis.clients.jedis.Protocol.read(Protocol.java:205)

2.解决方法：弄清楚到底有没有密码，密码是否正确。

### 七、事务异常 ###

1.异常堆栈

redis.clients.jedis.exceptions.JedisDataException: EXECABORT Transaction discarded because of previous errors

2.异常描述：

这个是Redis的事务异常：事务中包含了错误的命令，例如如下sett是个不存在的命令。

127.0.0.1:6379> multi
    OK
    127.0.0.1:6379> sett key world
    (error) ERR unknown command 'sett'
    127.0.0.1:6379> incr counter
    QUEUED
    127.0.0.1:6379> exec
    (error) EXECABORT Transaction discarded because of previous errors.

3.解决方法和处理人：

**客户**修复自身代码错误。

### 八、类转换错误 ###

1.异常堆栈

java.lang.ClassCastException: java.lang.Long cannot be cast to java.util.List
             at redis.clients.jedis.Connection.getBinaryMultiBulkReply(Connection.java:199)
             at redis.clients.jedis.Jedis.hgetAll(Jedis.java:851)
             at redis.clients.jedis.ShardedJedis.hgetAll(ShardedJedis.java:198)

java.lang.ClassCastException: java.util.ArrayList cannot be cast to [B
             at redis.clients.jedis.Connection.getBinaryBulkReply(Connection.java:182)
             at redis.clients.jedis.Connection.getBulkReply(Connection.java:171)
             at redis.clients.jedis.Jedis.rpop(Jedis.java:1109)
             at redis.clients.jedis.ShardedJedis.rpop(ShardedJedis.java:258)
    .......

2.异常描述：

Jedis正确的使用方法是：一个线程操作一个Jedis，通常来讲产生该错误是由于没有使用JedisPool造成的，例如如下代码在两个线程并发使用了一个Jedis。(get、hgetAll返回类型也是不一样的)

new Thread(new Runnable() {
    
        public void run() {
            for (int i = 0; i < 100; i++) {
                jedis.set("hello", "world");
                jedis.get("hello");
            }
        }
    }).start();
    
    new Thread(new Runnable() {
    
        public void run() {
            for (int i = 0; i < 100; i++) {
                jedis.hset("hashkey", "f", "v");
                jedis.hgetAll("hashkey");
            }
        }
    }).start();

3.解决方法和处理人：

客户排查自身代码是否存在上述问题

### 九、命令使用错误 ###

1.异常堆栈

Exception in thread "main" redis.clients.jedis.exceptions.JedisDataException: WRONGTYPE Operation against a key holding the wrong kind of value
        at redis.clients.jedis.Protocol.processError(Protocol.java:127)
        at redis.clients.jedis.Protocol.process(Protocol.java:161)
        at redis.clients.jedis.Protocol.read(Protocol.java:215)
    .....

2.异常描述：

例如key="hello"是字符串类型的键，而hgetAll是哈希类型的键，所以出现了错误。

jedis.set("hello","world");
    jedis.hgetAll("hello");

3.解决方法和处理人：

请客户修改自身代码错误。

### 十、Redis使用的内存超过maxmemory配置 ###

1.异常堆栈

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

2.异常描述：

Redis节点(如果是集群，则是其中一个节点)使用大于该实例的内存规格(maxmemory配置)。

3.解决方法：

原因可能有以下几个：

*  业务数据正常增加
 *  客户端缓冲区异常：例如使用了monitor、pub/sub使用不当等等
 *  纯缓存使用场景，但是maxmemory-policy配置有误(例如没有过期键的业务配置volatile-lru)

紧急处理，可以临时提工单帮助临时调整maxmeory，后续咨询用户是否升配或者调整配置。

4.处理人

*  客户：找到内存增大的原因。
 *  工单：协助临时调整maxmeomry，如果客户需要，可以协助解决

### 十一、Redis正在加载持久化文件 ###

1.异常堆栈

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

2.异常描述：

Jedis调用Redis时，如果Redis正在加载持久化文件，无法进行正常的读写。

3.解决方法：

正常情况下，阿里云Redis不会出现这种情况，如果出现，则提交工单处理。

4.处理人：

工单。

### 十二、Lua脚本超时 ###

1.异常堆栈

redis.clients.jedis.exceptions.JedisDataException: BUSY Redis is busy running a script. You can only call SCRIPT KILL or SHUTDOWN NOSAVE.

2.异常描述：

如果Redis当前正在执行Lua脚本，并且超过了lua-time-limit，此时Jedis调用Redis时，会收到下面的异常

3.解决方法：

按照异常提示：You can only call SCRIPT KILL or SHUTDOWN NOSAVE. (使用script kill:kill掉Lua脚本)

4.处理人：

最好客户自己处理，如果解决不了，值班人员可以协助操作。

### 十三 连接超时 ###

1.异常堆栈

redis.clients.jedis.exceptions.JedisConnectionException: java.net.SocketTimeoutException: connect timed out

2.异常描述：

可能产生的原因：

*  连接超时设置的过短。
 *  tcp-backlog满，造成新的连接失败。
 *  客户端与服务端网络不正常。

3.解决方法：

客户提供连接超时时间，提交工单定位相关原因。

4.处理人：

工单。

### 十四 Lua脚本写超时 ###

1.异常堆栈

(error) UNKILLABLE Sorry the script already executed write commands against the dataset. You can either wait the script termination or kill the server in a hard way using the SHUTDOWN NOSAVE command.

2.异常描述：

如果Redis当前正在执行Lua脚本，并且超过了lua-time-limit，**并且已经执行过写命令**，此时Jedis调用Redis时，会收到上面的异常

3.解决方法：

提交工单做紧急处理，管理员要做重启或者切换Redis节点。

4.处理人：

工单。

### 十五、类加载错误 ###

1.异常堆栈

例如找不到类和方法：

Exception in thread "commons-pool-EvictionTimer" java.lang.NoClassDefFoundError: redis/clients/util/IOUtils
        at redis.clients.jedis.Connection.disconnect(Connection.java:226)
        at redis.clients.jedis.BinaryClient.disconnect(BinaryClient.java:941)
        at redis.clients.jedis.BinaryJedis.disconnect(BinaryJedis.java:1771)
        at redis.clients.jedis.JedisFactory.destroyObject(JedisFactory.java:91)
        at         org.apache.commons.pool2.impl.GenericObjectPool.destroy(GenericObjectPool.java:897)
        at org.apache.commons.pool2.impl.GenericObjectPool.evict(GenericObjectPool.java:793)
        at org.apache.commons.pool2.impl.BaseGenericObjectPool$Evictor.run(BaseGenericObjectPool.java:1036)
        at java.util.TimerThread.mainLoop(Timer.java:555)
        at java.util.TimerThread.run(Timer.java:505)
    Caused by: java.lang.ClassNotFoundException: redis.clients.util.IOUtils
    ......

2.异常描述：

运行时，Jedis执行命令，抛出异常：某个类找不到。一般此类问题都是由于加载多个jedis版本(例如jedis 2.9.0和jedis 2.6)，在编译期代码未出现问题，但类加载器在运行时加载了低版本的Jedis，造成运行时找不到类。

3.解决方法：

通常此类问题，可以将重复的jedis排除掉，例如利用maven的依赖树，把无用的依赖去掉或者exclusion掉。

4.处理人

客户排查自身代码

### 十六、服务端命令不支持 ###

1.异常堆栈

例如客户端执行了geoadd命令，但是服务端返回不支持此命令

redis.clients.jedis.exceptions.JedisDataException: ERR unknown command 'GEOADD'

2.异常描述：

该命令不能被Redis端识别，有可能有两个原因：

*  社区版的一些命令，阿里云Redis的不支持，或者只在某些小版本上支持(例如geoadd是Redis 3.2添加的地理信息api)。
 *  命令本身是错误的(不过对于Jedis来说还好，不支持直接组装命令，每个API都有固定的函数)。

3.解决方法：

咨询是否有Redis版本支持该命令，如支持可以让客户做小版本升级。

4.处理人

*  管理员：确认版本是否支持该命令
 *  客户：确认后，做小版本升级

### 十七、pipeline错误使用 ###

1.异常堆栈

redis.clients.jedis.exceptions.JedisDataException: Please close pipeline or multi block before calling this method.

2.异常描述：

在pipeline.sync()执行之前，通过response.get()获取值，在pipeline.sync()执行前，命令没有执行(可以通过monitor做验证)，下面代码就会引起上述异常

Jedis jedis = new Jedis("127.0.0.1", 6379);
    Pipeline pipeline = jedis.pipelined();
    pipeline.set("hello", "world"); 
    pipeline.set("java", "jedis");
        
    Response<String> pipeString = pipeline.get("java");
    //这个get必须在sync之后，如果是批量获取值建议直接用List<Object> objectList = pipeline.syncAndReturnAll();
    System.out.println(pipeString.get());
    //命令此时真正执行
    pipeline.sync();

Jedis中Reponse中get()方法，有个判断:如果set=false就会报错，而response中的set初始化为false.

public T get() {
      // if response has dependency response and dependency is not built,
      // build it first and no more!!
      if (dependency != null && dependency.set && !dependency.built) {
        dependency.build();
      }
      if (!set) {
        throw new JedisDataException(
            "Please close pipeline or multi block before calling this method.");
      }
      if (!built) {
        build();
      }
      if (exception != null) {
        throw exception;
      }
      return response;
    }

pipeline.sync()会每个结果设置set=true。

public void sync() {
      if (getPipelinedResponseLength() > 0) {
        List<Object> unformatted = client.getAll();
        for (Object o : unformatted) {
          generateResponse(o);
        }
      }
    }

其中generateResponse(o):

protected Response<?> generateResponse(Object data) {
      Response<?> response = pipelinedResponses.poll();
      if (response != null) {
        response.set(data);
      }
      return response;
    }

其中response.set(data);

public void set(Object data) {
        this.data = data;
        set = true;
    }

3.解决方法：

实际上对于批量结果的解析，建议使用pipeline.syncAndReturnAll()来实现，下面操作模拟了批量hgetAll

/**
    * pipeline模拟批量hgetAll
    * @param keyList
    * @return
    */
    public Map<String, Map<String, String>> mHgetAll(List<String> keyList) {
    // 1.生成pipeline对象
    Pipeline pipeline = jedis.pipelined();
    // 2.pipeline执行命令，注意此时命令并未真正执行
    for (String key : keyList) {
      pipeline.hgetAll(key);
    }
    // 3.执行命令 syncAndReturnAll()返回结果
    List<Object> objectList = pipeline.syncAndReturnAll();
    if (objectList == null || objectList.isEmpty()) {
      return Collections.emptyMap();
    }
        
    // 4.解析结果
    Map<String,Map<String, String>> resultMap = new HashMap<String, Map<String,String>>();
    for (int i = 0; i < objectList.size(); i++) {
      Object object = objectList.get(i);
      Map<String, String> map = (Map<String, String>) object;
      String key = keyList.get(i);
      resultMap.put(key, map);
    }
    return resultMap;
    }

4.处理人：

修改业务代码。

### 十八、管理员命令，普通用户不能执行 ###

1.异常堆栈

命令role不能被普通用户执行，可以参考[暂未开放的Redis命令][Redis]

redis.clients.jedis.exceptions.JedisDataException: ERR command role not support for normal user

2.异常描述：

改命令尚未开放

3.解决方法：

不能使用该命令，如果有需求或者疑问可以联系值班人员。

4.处理人

从文档中确认该命令是否开放

### 其他问题： ###

1.Jedis版本如何选择：

原则上选择最新的[release版本][release]，但最好选择release一段时间后的版本，因为jedis历史上出现过一次问题较大的release版本，目前来说2.9.0比较稳定。

<dependency>
        <groupId>redis.clients</groupId>
        <artifactId>jedis</artifactId>
        <version>2.9.0</version>
        <type>jar</type>
        <scope>compile</scope>
    </dependency>

2.Jedis中的JedisCluster是阿里云Redis集群版的客户端吗？

答：不是，使用阿里云集群版的客户端，直接使用Jedis和JedisPool即可。因为官方集群和阿里云Redis集群是不同的架构，具体参考：[redis4.0、codis、阿里云redis 3种redis集群对比分析][redis4.0_codis_redis 3_redis]

### ......其他待补充...... ###

附赠连接池参数

1. 资源设置和使用

<table> 
 <thead> 
  <tr> 
   <th>序号</th> 
   <th>参数名</th> 
   <th>含义</th> 
   <th>默认值</th> 
   <th>使用建议</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1</td> 
   <td>maxTotal</td> 
   <td>资源池中最大连接数</td> 
   <td>8</td> 
   <td>设置建议见下节</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>maxIdle</td> 
   <td>资源池允许最大空闲的连接数</td> 
   <td>8</td> 
   <td>设置建议见下节</td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td>minIdle</td> 
   <td>资源池确保最少空闲的连接数</td> 
   <td>0</td> 
   <td>设置建议见下节</td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td>blockWhenExhausted</td> 
   <td>当资源池用尽后，调用者是否要等待。只有当为true时，下面的maxWaitMillis才会生效</td> 
   <td>true</td> 
   <td>建议使用默认值</td> 
  </tr> 
  <tr> 
   <td>5</td> 
   <td>maxWaitMillis</td> 
   <td>当资源池连接用尽后，调用者的最大等待时间(单位为毫秒)</td> 
   <td>-1：表示永不超时</td> 
   <td>不建议使用默认值</td> 
  </tr> 
  <tr> 
   <td>6</td> 
   <td>testOnBorrow</td> 
   <td>向资源池借用连接时是否做连接有效性检测(ping)，无效连接会被移除</td> 
   <td>false</td> 
   <td>业务量很大时候建议设置为false(多一次ping的开销)。</td> 
  </tr> 
  <tr> 
   <td>7</td> 
   <td>testOnReturn</td> 
   <td>向资源池归还连接时是否做连接有效性检测(ping)，无效连接会被移除</td> 
   <td>false</td> 
   <td>业务量很大时候建议设置为false(多一次ping的开销)。</td> 
  </tr> 
  <tr> 
   <td>8</td> 
   <td>jmxEnabled</td> 
   <td>是否开启jmx监控，可用于监控</td> 
   <td>true</td> 
   <td>建议开启，但应用本身也要开启</td> 
  </tr> 
 </tbody> 
</table>

2.空闲资源监测

空闲Jedis对象检测，下面四个参数组合来完成，testWhileIdle是该功能的开关。

<table> 
 <thead> 
  <tr> 
   <th>序号</th> 
   <th>参数名</th> 
   <th>含义</th> 
   <th>默认值</th> 
   <th>使用建议</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1</td> 
   <td>testWhileIdle</td> 
   <td>是否开启空闲资源监测</td> 
   <td>false</td> 
   <td>true</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>timeBetweenEvictionRunsMillis</td> 
   <td>空闲资源的检测周期(单位为毫秒)</td> 
   <td>-1：不检测</td> 
   <td>建议设置，周期自行选择，也可以默认也可以使用下面JedisPoolConfig中的配置</td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td>minEvictableIdleTimeMillis</td> 
   <td>资源池中资源最小空闲时间(单位为毫秒)，达到此值后空闲资源将被移除</td> 
   <td>1000<em>60&nbsp;</em>30 = 30分钟</td> 
   <td>可根据自身业务决定，大部分默认值即可，也可以考虑使用下面JeidsPoolConfig中的配置</td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td>numTestsPerEvictionRun</td> 
   <td>做空闲资源检测时，每次的采样数</td> 
   <td>3</td> 
   <td>可根据自身应用连接数进行微调,如果设置为-1，就是对所有连接做空闲监测</td> 
  </tr> 
 </tbody> 
</table>

[https_yq.aliyun.com_articles_236384_spm_a2c4e.11155435.0.0.e21e2612uQAVoW_cc1]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc1
[redis.clients.jedis.exceptions.JedisConnectionException_ Unexpected end of stream]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc2
[redis.clients.jedis.exceptions.JedisDataException_ ERR illegal address]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc3
[redis.clients.jedis.exceptions.JedisDataException_ ERR max number of clients reached]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc4
[redis.clients.jedis.exceptions.JedisConnectionException_ java.net.SocketTimeoutException_ Read timed out]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc5
[redis.clients.jedis.exceptions.JedisDataException_ NOAUTH Authentication required]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc6
[redis.clients.jedis.exceptions.JedisDataException_ EXECABORT Transaction discarded because of previous errors]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc7
[java.lang.ClassCastException_ java.lang.Long cannot be cast to java.util.List]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc8
[redis.clients.jedis.exceptions.JedisDataException_ WRONGTYPE Operation against a key holding the wrong kind of value]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc9
[redis.clients.jedis.exceptions.JedisDataException_ OOM command not allowed when used memory _ _maxmemory]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc10
[redis.clients.jedis.exceptions.JedisDataException_ LOADING Redis is loading the dataset in memory]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc11
[redis.clients.jedis.exceptions.JedisDataException_ BUSY Redis is busy running a script. You can only call SCRIPT KILL or SHUTDOWN NOSAVE.]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc12
[redis.clients.jedis.exceptions.JedisConnectionException_ java.net.SocketTimeoutException_ connect timed out]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc13
[UNKILLABLE Sorry the script already executed write commands against the dataset. You can either wait the script termination or kill the server in a hard way using the SHUTDOWN NOSAVE command.]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc14
[java.lang.NoClassDefFoundError]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc15
[redis.clients.jedis.exceptions.JedisDataException_ ERR unknown command]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc16
[redis.clients.jedis.exceptions.JedisDataException_ Please close pipeline or multi block before calling this method.]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc17
[redis.clients.jedis.exceptions.JedisDataException_ ERR command role not support for normal user.]: https://yq.aliyun.com/articles/236384?spm=a2c4e.11155435.0.0.e21e2612uQAVoW#cc18
[1]: /images/20220322/a437f69c812f4bf6a52e95e812645ed2.png
[Jedis]: https://yq.aliyun.com/articles/73894?spm=5176.8091938.0.0.iOI0kR
[JedisPool]: https://yq.aliyun.com/articles/236383?spm=5176.8091938.0.0.qVO71y
[9dac508bb5669a6e690bdbbedf6e98c82581e1e1.png]: /images/20220322/dc65d324a1604014bb12783ecb31d018.png
[Redis]: https://help.aliyun.com/document_detail/26356.html
[release]: https://github.com/xetorthio/jedis/releases
[redis4.0_codis_redis 3_redis]: https://yq.aliyun.com/articles/68593