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();
业务并发量大（maxTotal值设置得过小）
业务并发量大导致出现异常的示例：一次命令运行时间（borrow|return resource + Jedis执行命令 + 网络时间）的平均耗时约为1ms，一个连接的QPS大约是1000，业务期望的QPS是50000，则理论上需要的资源池大小为50000 / 1000 = 50。
此时，您可以在客户端所在的设备上执行下述命令，该命令返回的结果为连接客户端的连接数，您可以根据该数值对maxTotal值进行调整。
netstat -an | grep 6379 | grep EST | wc -l
Jedis连接阻塞
当Redis发生了阻塞时（例如慢查询等原因），所有连接会在超时时间范围内等待，当并发量较大时，会造成连接池资源不足，更多信息请参见连接超时。
Jedis连接被拒绝
从连接池中获取连接时，由于没有空闲连接，需要重新生成一个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.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) ......
这个异常描述是客户端缓冲区异常，产生这个问题可能有下列三个原因。
多个线程使用一个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();
客户端缓冲区满了
Redis有下列三种客户端缓冲区。
普通客户端缓冲区(normal)：用于接受普通的命令，例如get、set、mset、hgetall、zrange等。
slave客户端缓冲区(slave)：用于同步master节点的写命令，完成复制。
发布订阅缓冲区(pubsub)：pubsub不是普通的命令，因此有单独的缓冲区。
Redis客户端缓冲区配置的格式如下。
client-output-buffer-limit [$Class] [$Hard_Limit] [$Soft_Limit] [$Soft_Seconds]
[$Class]：客户端类型，可选值为normal、slave和pubsub。
[$Hard_Limit]：如果客户端使用的输出缓冲区大于hard limit，客户端会被立即关闭，单位为秒。
[$Soft_Limit]和[$Soft_Seconds]：如果客户端使用的输出缓冲区超过了soft limit，并且持续了soft 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"
长时间闲置连接
长时间闲置连接会被服务端主动断开，可以查询timeout配置的设置以及自身连接池配置确定是否需要做空闲检测。
排查自身代码是否使用JedisPool管理Jedis连接，是否存在并发操作Jedis的情况。
排查是否是上述客户端缓冲区空间不足或长时间闲置连接的原因。云数据库Redis版默认的timeout值为0，表示不会主动关闭用户连接，目前该值不支持修改。client-output-buffer-limit默认值为500MB，为阿里云优化后的合理值。如果超过该值，说明用户返回的值过多，出于性能和稳定性考虑，建议优化应用程序。
问题三：非法的客户端地址
异常堆栈如下。
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)
......
向*添加一个成员时，例如使用SET TEST "Helloworld"命令，出现下列报错，也可能是白名单问题。
ERR illegal address
Redis实例配置了白名单，但当前访问Redis的客户端（IP）不在白名单中。
添加该客户端（IP）的白名单，关于如何添加白名单，请参考设置IP白名单。
问题四：客户端连接数达到最大值
异常堆栈如下。
redis.clients.jedis.exceptions.JedisDataException: ERR max number of clients reached
客户端连接数超过了Redis实例配置的最大maxclients。
定位自身问题，可以定位连接最多的客户端，找到问题原因，例如连接池配置等，然后进行处理。
问题五：客户端读写超时
redis.clients.jedis.exceptions.JedisConnectionException: java.net.SocketTimeoutException: Read timed out
问题原因可能有下列几种。
读写超时设置的过短。
有慢查询或者Redis发生阻塞。
网络不稳定。
您可以通过实例诊断，查看实例在对应时间点是否存在性能问题或异常。
问题六：密码相关的异常
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)
请使用正确的密码和密码格式，更多信息请参见Redis实例访问方式。
问题七：事务异常
异常堆栈如下。
redis.clients.jedis.exceptions.JedisDataException: EXECABORT Transaction discarded because of previous errors
这个是Redis的事务异常，事务中包含了错误的命令，例如，下列sett是个不存在的命令。
127.0.0.1:6379> multi
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.
查看自身代码逻辑，修复代码错误。
问题八：类转换错误
异常堆栈如下。
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)
.......
Jedis正确的使用方法是，一个线程操作一个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();
解决方法和处理途径
用户排查自身代码是否存在问题。
问题九：命令使用错误
异常堆栈如下。
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)
.....
例如key=”hello”是字符串类型的键，而hgetAll返回哈希类型的键，所以出现了错误。
jedis.set("hello","world");
jedis.hgetAll("hello");
解决方法和处理途径
请用户修改自身代码错误。
问题十：Redis使用的内存超过maxmemory配置
Redis节点（如果是集群，则是其中一个节点）使用内存大于该实例的内存规格（maxmemory配置）。异常堆栈如下。
redis.clients.jedis.exceptions.JedisDataException: OOM command not allowed when used memory > 'maxmemory'.
原因可能有下列几种：
业务数据正常增加。
客户端缓冲区异常，例如monitor、pub/sub使用不当等等。
纯缓存使用场景，但是maxmemory-policy配置有误（例如没有设置过期键的业务配置volatile-lru）。
请查看您Redis实例是否负载过高，如果您是集群版，需要查看每个分片是否负载过高。如果存在大Key，请参见离线全量Key分析和如何搜索过大的Key，分析获取大Key。
确认内存增大的原因，根据自身业务场景解决问题。
如无以上问题，您可以升级实例规格，或开启实例规格自动扩容。
问题十一：无法执行ROLE命令
ROLE命令不能被普通用户执行，详情可参考暂未开放的Redis命令。
redis.clients.jedis.exceptions.JedisDataException: ERR command role not support for normal user
该命令尚未开放。
暂不支持使用该命令。
问题十二：Lua脚本超时
异常堆栈如下。
redis.clients.jedis.exceptions.JedisDataException: BUSY Redis is busy running a script. You can only call SCRIPT KILL or SHUTDOWN NOSAVE.
如果Redis当前正在执行Lua脚本，并且超过了lua-time-limit，此时Jedis调用Redis时，会收到上述异常。
按照异常提示You can only call SCRIPT KILL or SHUTDOWN NOSAVE.，使用kill命令终止Lua脚本。
问题十三：连接超时
redis.clients.jedis.exceptions.JedisConnectionException: java.net.SocketTimeoutException: connect timed out
如果是首次访问该Redis实例，请检查：
白名单设置是否正确，未加入白名单的客户端无法访问对应实例，更多信息请参见设置白名单。
网络，确保您的客户端和Redis实例的域名连通性，更多信息请参见使用ping命令检测ECS与Redis之间的连接。
请使用正确的账号和密码，更多信息请参见Redis实例访问方式。
如果您是在运行期间出现无法连接请检查：
实例是否由于高可用触发了主备切换。在主备切换期间会出现连接闪断，因此您的程序可能会短暂报错无法连接，请为您的程序设计重连机制。
可通过实例诊断，查看实例在对应时间点是否存在性能问题或异常。
问题十四：Lua脚本写超时
异常堆栈如下。
(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.
如果Redis当前正在执行Lua脚本，并且超过了lua-time-limit，并且已经执行过写命令，此时Jedis调用Redis时，会收到上述异常。
重启实例，更多信息请参见重启实例。
问题十五：类加载错误
找不到类和方法的异常堆栈如下。
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
......
运行时，Jedis执行命令，抛出异常，提示某个类找不到。此类问题一般都是由于加载多个jedis版本（例如jedis 2.9.0和jedis 2.6），在编译期间代码未出现问题，但类加载器在运行时加载了低版本的Jedis，造成运行时找不到类。
通常此类问题，可以将重复的Jedis排除掉，例如利用Maven的依赖树，把无用的依赖去掉或者exclusion掉。
问题十六：服务端命令不支持
例如客户端执行了GEOADD命令，但是服务端返回不支持此命令。
redis.clients.jedis.exceptions.JedisDataException: ERR unknown command 'GEOADD'
该命令不能被Redis端识别，可能有下列两个原因。
社区版的一些命令，阿里云Redis不支持，或者只在某些小版本上支持，例如GEOADD是Redis 3.2添加的地理信息API。
命令本身是错误的，不过对于Jedis来说不能识别，Jedis不支持直接使用命令，每个API都有固定的函数。
请确认Redis当前版本是否支持该命令，更多信息请参见Redis社区版命令支持，如有需要，您也可以升级实例版本，更多信息请参见升级小版本。
问题十七：pipeline错误使用
异常堆栈如下。
redis.clients.jedis.exceptions.JedisDataException: Please close pipeline or multi block before calling this method.
在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;
对于批量结果的解析，建议使用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;
检查并修改业务代码。
Jedis版本如何选择
建议选择最新的release版本。
<dependency>
<groupId>redis.clients</groupId>
<artifactId>jedis</artifactId>
<version>Latest version</version>
<type>jar</type>
<scope>compile</scope>
</dependency>
连接池参数
JedisPool资源池优化
资源设置和使用
资源设置和使用如下。
资源池中资源最小空闲时间（单位为毫秒），达到此值后空闲资源将被移除
1000 * 60 * 30 = 30分钟
可根据自身业务决定，大部分默认值即可，也可以考虑使用下面JeidsPoolConfig中的配置
numTestsPerEvictionRun
做空闲资源检测时，每次的采样数
可根据自身应用连接数进行微调，如果设置为-1，就是对所有连接做空闲监测
云数据库 Redis
