INFO 命令必须通过 RedisTemplate.execute() 获取 RedisConnection 后调用 executeCommand() 执行,因其不走键值操作路径、响应为非结构化多行文本,executePipelined() 会解析失败;推荐指定 section 以减少开销,并注意 ACL 权限与响应格式不确定性。

INFO 是 Redis 服务端命令,不走常规的键值操作路径,RedisTemplate 默认提供的 opsForValue()、opsForHash() 等操作器无法直接调用它。必须绕过高层封装,使用底层 RedisConnection 才能执行。
RedisTemplate.execute() 是唯一可行入口
execute() 方法允许你拿到原生的 RedisConnection 实例,进而调用 executeCommand() 或直接写入协议字节。对 INFO 这类无参数、返回字符串的只读命令,推荐用 executeCommand():
- 它自动处理命令编码、响应解析(返回
byte[]) - 不需要手动拼接 RESP 协议或处理连接生命周期
- 比
executePipelined()更轻量,适合单条管理命令
示例代码:
@Autowired
private RedisTemplate<String, Object> redisTemplate;
<p>public String getRedisInfo() {
return (String) redisTemplate.execute((RedisCallback<Object>) connection -> {
byte[] rawResult = connection.executeCommand("INFO");
return rawResult != null ? new String(rawResult) : "";
});
}注意:返回值是 byte[],需转成 String;若 Redis 配置了密码,该调用仍受连接工厂认证控制,无需额外处理。
为什么不能用 executePipelined() 调 INFO?
executePipelined() 内部会把所有命令批量发往服务端,并期望每条命令都有对应的数据结构化响应(如 SET 返回 OK,GET 返回 byte[] 值)。但 INFO 的响应是多行纯文本,含换行符和冒号分隔的段落,executePipelined() 会尝试将其按 RESP 协议解析,大概率抛出 SerializationException 或返回乱码。
常见错误现象:
- 返回值为
null或空集合 - 日志出现
Cannot deserialize; nested exception is java.io.StreamCorruptedException - 实际响应被截断或解析失败(尤其当 INFO 输出含非 ASCII 字符时)
所以,单条管理命令请坚持用 execute() + executeCommand() 组合。
注意 INFO 命令的权限与响应体积
- 如果 Redis 启用了 ACL(如
redis.conf中配置了requirepass或 ACL 规则),确保连接用户拥有INFO权限(默认allkeys用户有,但最小权限用户可能被禁用) -
INFO默认返回全部模块信息(INFO default),响应体可能达数 KB。生产环境建议指定 section,例如:connection.executeCommand("INFO", "memory")-
connection.executeCommand("INFO", "stats")这能显著减少网络传输和解析开销
另外,Spring Boot 3.x + Lettuce 客户端下,executeCommand() 对多参数命令需传 byte[][],但 INFO 单参数可直接传 String —— Lettuce 会自动转码,无需手动生成 byte[]。
INFO 不是数据操作命令,它不参与事务、不支持 pipeline 批量,也不受序列化器影响;真正容易被忽略的是它的响应格式不可预测(不同 Redis 版本字段略有差异),别把它当结构化 API 用 —— 解析时优先用正则或逐行扫描,而不是强依赖固定字段顺序。


















