spring boot 2.x 切换 jedis 需三步：排除 lettuce-core 依赖、引入 jedis 依赖、显式配置 jedisconnectionfactory bean；同时 application.yml 中连接池配置须用 spring.redis.jedis.pool.* 前缀，且参数名如 time-between-eviction-runs-millis 不可省略 -millis 后缀。
Spring Boot 2.x 起默认用 Lettuce，想切回 Jedis 不是改个配置就行，必须显式排除默认依赖、引入 jedis、并重写连接工厂 —— 否则 RedisTemplate 仍会走 Lettuce 实现，甚至启动报 Cannot get Jedis connection。
排除 lettuce-core 并引入 jedis 依赖
Spring Boot 的 spring-boot-starter-data-redis 默认带 io.lettuce:lettuce-core，不手动排除就会冲突。Maven 必须做两件事：
- 在
spring-boot-starter-data-redis中用<exclusions></exclusions>去掉lettuce-core - 单独添加
redis.clients:jedis（建议用4.4.3或更高，兼容 Spring Boot 3.x；若用 2.x，3.9.0是较稳版本）
示例 pom.xml 片段：
<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>redis.clients</groupid><artifactid>jedis</artifactid><version>4.4.3</version></dependency>
application.yml 中的连接池参数名完全不同
Jedis 和 Lettuce 的连接池配置项前缀不同，且部分参数语义不一致 —— 直接复用原有 spring.redis.lettuce.pool.* 配置会导致被忽略。
- Jedis 使用
spring.redis.jedis.pool.*（Spring Boot 2.3+ 支持，旧版需靠 Java Config） - 关键参数映射：
max-active→max-active（同名但含义一致），max-wait→max-wait，但min-idle/max-idle在 Jedis 中对应JedisPoolConfig的原生字段，YAML 中写法一样 - 注意：
time-between-eviction-runs在 Jedis 中叫time-between-eviction-runs-millis，少写-millis后缀会静默失效
正确 YAML 示例：
spring:
redis:
host: 127.0.0.1
port: 6379
password:
timeout: 5000
jedis:
pool:
max-active: 20
max-idle: 10
min-idle: 2
max-wait: 2000
time-between-eviction-runs-millis: 30000
必须重写 RedisConnectionFactory 才能生效
仅改依赖和 YAML 不够。Spring Boot 自动配置会尝试创建 LettuceConnectionFactory，而它找不到 lettuce-core 就会失败或 fallback 到空实现。你得提供一个 @Bean 显式返回 JedisConnectionFactory。
- 构造时传入
JedisPoolConfig（可从 YAML 自动绑定，也可手写）和RedisStandaloneConfiguration - 别漏掉
setUsePooling(true)，否则即使配了 pool 参数也走单连接 - 如果用了密码或 database，必须在
RedisStandaloneConfiguration中设置，不能只靠 YAML 的spring.redis.password
精简 Java Config 示例：
@Configuration
public class RedisConfig {
@Bean
public JedisConnectionFactory jedisConnectionFactory(RedisProperties properties) {
RedisStandaloneConfiguration config = new RedisStandaloneConfiguration();
config.setHostName(properties.getHost());
config.setPort(properties.getPort());
config.setPassword(RedisPassword.of(properties.getPassword()));
config.setDatabase(properties.getDatabase());
JedisClientConfiguration.JedisClientConfigurationBuilder builder =
JedisClientConfiguration.builder();
builder.usePooling();
builder.poolConfig(jedisPoolConfig(properties.getJedis().getPool()));
return new JedisConnectionFactory(config, builder.build());
}
private JedisPoolConfig jedisPoolConfig(RedisProperties.Pool pool) {
JedisPoolConfig config = new JedisPoolConfig();
config.setMaxTotal(pool.getMaxActive());
config.setMaxIdle(pool.getMaxIdle());
config.setMinIdle(pool.getMinIdle());
config.setMaxWaitMillis(pool.getMaxWait().toMillis());
config.setTimeBetweenEvictionRunsMillis(
pool.getTimeBetweenEvictionRuns().toMillis());
return config;
}
}
最常被跳过的点：没重写 JedisConnectionFactory Bean，或 YAML 里写了 lettuce.pool 却以为它对 Jedis 也起作用 —— 这两类错误都会导致运行时连接异常或连接池参数完全不生效。
