<think>我们正在解决Spring Boot应用连接
Redis时出现的HEXPIRE错误。根据之前的分析，这个错误通常与Lettuce版本不兼容或
Redis服务器版本过低有关。同时，Spring Boot 3
.5+的配置格式有所变化。
解决方案：
1. 确保使用兼容的Lettuce版本（如6
.3
.2.RELEASE），并在pom
.xml中排除旧版本后显式引入。
2. 在application
.properties（或application
.yml）中正确配置
Redis连接信息，注意Spring Boot 3
.5+的配置前缀是`spring
.data
.redis`。
3
. 检查
Redis服务器版本，确保是6
.2或以上。
由于用户要求提供完整的application
.properties配置代码，我们提供properties格式的配置。
注意：以下配置假设
Redis服务器运行在本地，端口6379，无密码（如果有密码请设置password属性）。同时，我们配置了连接池参数（可选但推荐）。
在application
.properties中配置如下：
```properties
# 服务器端口
server
.port
=8080
#
Redis配置（Spring Boot 3
.5+）
spring
.data
.redis.host
=127
.0
.0
.1
spring
.data
.redis.port
=6379
# 如果有密码
# spring
.data
.redis.password
=yourpassword
# 选择数据库索引（0
-15）
spring
.data
.redis.database
=0
# 连接超时时间（毫秒）
spring
.data
.redis.timeout
=5000
# Lettuce连接池配置（可选，但推荐配置以优化性能）
spring
.data
.redis.lettuce
.pool
.max
-active
=16
spring
.data
.redis.lettuce
.pool
.max
-idle
=8
spring
.data
.redis.lettuce
.pool
.min
-idle
=4
spring
.data
.redis.lettuce
.pool
.max
-wait
=2000ms
```
如果问题仍然存在，请检查：
1. 依赖中是否排除了旧版本的Lettuce，并引入了6
.3
.2.RELEASE版本（参考之前的pom
.xml配置）。
2. Redis服务器版本是否过低（低于6
.2）。如果是，请升级
Redis或使用Jedis客户端（配置方式不同）。
如果需要切换到Jedis，在pom
.xml中排除Lettuce并添加Jedis依赖，然后在application
.properties中添加：
```properties
# 指定使用Jedis
spring
.data
.redis.client
-type
=jedis
# Jedis连接池配置
spring
.data
.redis.jedis
.pool
.max
-active
=16
spring
.data
.redis.jedis
.pool
.max
-idle
=8
spring
.data
.redis.jedis
.pool
.min
-idle
=4
spring
.data
.redis.jedis
.pool
.max
-wait
=2000ms
```
最后，请确保清理Maven本地仓库并重新构建项目。
如果以上步骤仍不能解决问题，请提供更详细的错误日志。
§§相关问题§§
1. 如何在Spring Boot中检查实际使用的Lettuce版本？
2. 如何升级
Redis服务器到6
.2或更高版本？
3
. 在Spring Boot 3
.5中，除了连接池配置，还有哪些重要的
Redis配置项？
4
. 如何通过Spring Boot的健康检查来验证
Redis连接是否正常？
5
. 在
Redis 6
.2中，HEXPIRE命令的作用是什么？它和EXPIRE有什么区别？</think>### 解决 Spring Boot 连接
Redis 的 HEXPIRE 错误（完整配置）
#### 核心问题原因
`HEXPIRE` 错误通常由以下原因导致：
1. **Lettuce 版本不兼容**：Spring Boot 3
.5+ 需要 Lettuce 6
.3
.2+[^
1]
2. **
Redis 服务器版本过低**：HEXPIRE 命令需要
Redis 6
.2+ 支持
3
. **连接池配置缺失**：未显式配置 Lettuce 连接池参数
---
### 完整的 `application
.properties` 配置
```properties
#
========== 基础配置
==========
server
.port
=8080
server
.servlet
.context
-path
=/api
#
========== Redis 核心配置
==========
# 注意：Spring Boot 3
.5+ 使用 spring
.data
.redis 前缀[^
1]
spring
.data
.redis.host
=127
.0
.0
.1
spring
.data
.redis.port
=6379
spring
.data
.redis.password
=your_password # 无密码时注释此行
spring
.data
.redis.database
=0
spring
.data
.redis.timeout
=5000 # 连接超时(毫秒)
#
========== Lettuce 连接池配置
==========
# 必须显式配置连接池参数[^
1]
spring
.data
.redis.lettuce
.pool
.max
-active
=16
spring
.data
.redis.lettuce
.pool
.max
-idle
=8
spring
.data
.redis.lettuce
.pool
.min
-idle
=4
spring
.data
.redis.lettuce
.pool
.max
-wait
=2000ms # 等待连接超时
#
========== 日志配置
==========
logging
.level
.root
=info
logging
.level
.org
.springframework
.data
.redis=debug # 开启
Redis操作日志
logging
.file
.name
=logs/application
.log # 日志文件路径
```
---
### 必须的依赖调整（pom
.xml）
```xml
<dependencies>
<!
-- 排除旧版 Lettuce
-->
<dependency>
<groupId>org
.springframework
.boot</groupId>
<artifactId>spring
-boot
-starter
-data
-redis</artifactId>
<exclusions>
<exclusion>
<groupId>io
.lettuce</groupId>
<artifactId>lettuce
-core</artifactId>
</exclusion>
</exclusions>
</dependency>
<!
-- 强制使用兼容版本
-->
<dependency>
<groupId>io
.lettuce</groupId>
<artifactId>lettuce
-core</artifactId>
<
version>6
.3
.2.RELEASE</
version> <!
-- 必须版本
-->
</dependency>
</dependencies>
```
---
### 验证
Redis 服务器版本
```bash
# Windows 命令提示符
redis-cli info server | findstr "
redis_
version"
# Linux/macOS
redis-cli info server | grep
redis_
version
```
输出应为：
`
redis_
version:6
.2.x` 或更高版本
若版本低于 6
.2，需升级
Redis 或添加兼容层：
```java
@Configuration
public class
RedisCompatibilityConfig {
@Bean
public
RedisTemplate<?, ?>
redisTemplate(
RedisConnectionFactory factory) {
RedisTemplate<?, ?> template
= new
RedisTemplate<>();
template
.setConnectionFactory(factory);
// 禁用新命令兼容旧版
Redis
template
.setEnableDefaultSerializer(false);
return template;
}
}
```
---
### 最终验证步骤
1. 清理 Maven 本地仓库：删除 `~/
.m
2/repository/io/lettuce`
2. 重启
Redis 服务：`
redis-cli shutdown &&
redis-server`
3
. 启动 Spring Boot 应用
成功启动日志应包含：
`LettuceConnectionFactory initialized with pool [LettucePool]`
---
### 相关问题
1. 如何在 Spring Boot 中查看实际生效的
Redis 客户端版本？
2. Lettuce 和 Jedis 在 Spring Boot 3
.5 中的性能对比有何差异？
3
. Redis 6
.2 的 HEXPIRE 命令相比 EXPIRE 有哪些优势？
4
. Spring Boot 3
.5 对
Redis 7
.0 的新特性支持情况如何？
5
. 如何动态监控 Spring Boot 应用的
Redis 连接池状态？[^
1]
解决Redis集群安装过程中遇到的Ruby版本不匹配问题，通过安装RVM管理Ruby版本，选择合适的Ruby版本安装Redis。
扫一扫
2万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
