Redis连接池不生效需显式配置LettuceClientConfigurationBuilder并传入poolConfig；entryTtl失效多因序列化器不一致或未启用key前缀；云Redis需用rediss://协议并删除URI路径，推荐分项配置SSL与地址。
Redis连接池不生效，LettuceClientConfigurationBuilder被忽略怎么办
Spring Boot 2.0+ 默认用 Lettuce，不是 Jedis；它默认不启用连接池，直接复用单个连接——高并发下会卡死或超时。很多人配了 spring.redis.lettuce.pool 却没效果，是因为没显式启用池化配置。
- 必须在配置类里手动构建
LettuceClientConfigurationBuilder，并传入GenericObjectPoolConfig -
spring.redis.lettuce.pool.max-active等属性只有在启用池化后才起作用，否则完全被忽略 - 别用
@EnableCaching就以为缓存自动走池——它只管切面，不管底层连接怎么建
@Bean
public ClientResources clientResources() {
return DefaultClientResources.builder()
.ioThreadPoolSize(4)
.computationThreadPoolSize(4)
.build();
}
@Bean
public LettuceClientConfiguration lettuceClientConfiguration(
GenericObjectPoolConfig<?> poolConfig) {
return LettuceClientConfiguration.builder()
.clientResources(clientResources())
.commandTimeout(Duration.ofSeconds(2))
.pool(poolConfig) // ← 关键：必须显式传入
.build();
}
RedisCacheConfiguration 的 entryTtl 不生效的典型原因
设了 entryTtl(Duration.ofMinutes(10))，但缓存项永远不过期，大概率是 RedisTemplate 序列化方式和 CacheManager 不一致导致的元数据丢失。
- CacheManager 用的是
StringRedisTemplate的序列化器（StringRedisSerializer），而你自定义的RedisTemplate可能用了JdkSerializationRedisSerializer——两者对 key/value 的编码不兼容，TTL 指令根本发不到服务端 - Spring Boot 2.6+ 默认禁用
usePrefix，但RedisCacheWriter内部仍依赖 key 前缀来识别缓存名，没前缀会导致 TTL 设置被跳过 - 别在
@Cacheable里硬写cacheNames = "user"而不注册对应RedisCacheConfiguration实例——没匹配上的 cacheName 会 fallback 到默认无 TTL 配置
生产环境必须调的三个 GenericObjectPoolConfig 参数
默认池配置太保守，压测时容易出现 org.springframework.dao.InvalidDataAccessResourceUsageException: Unable to create a new connection 或连接耗尽。
-
setMaxTotal(50)：默认 -1（无限制），但 Redis 单实例建议上限 200，按应用实例数分摊 -
setMaxIdle(20)：避免空闲连接长期占着资源，同时保证突发流量有缓冲 -
setMinIdle(5)：防止冷启动后首请求慢；注意 Spring Boot 的min-idle属性在 2.4+ 后已废弃，必须代码里设
漏设 setTimeBetweenEvictionRunsMillis(30_000) 会导致失效连接堆积，尤其在 Redis 临时断连又恢复后，客户端还拿着已关闭的 socket。
本地开发用 redis://localhost:6379，上线却连不上云 Redis 的真实原因
错误信息常是 Cannot connect to redis at /10.0.1.22:6379 或 Connection refused，但 telnet 能通——问题不在网络，而在 Lettuce 的 URI 解析逻辑。
- 云 Redis（如阿里云、腾讯云）通常要求开启 SSL，但
redis://协议不支持；必须改用rediss://（注意多一个 s），并配ssl=true - 部分云厂商返回的地址带路径（如
rediss://r-bp1xxx.redis.rds.aliyuncs.com:6379/0），Lettuce 会把/0当作数据库索引，但实际应由database参数控制；URI 中的路径必须删掉 - Spring Boot 2.3+ 对 URI 的解析更严格，
redis://host:port?timeout=2000这种写法会被忽略 query 参数，得统一用spring.redis.*配置项
最稳的方式：别拼 URI，老老实实用 spring.redis.host、spring.redis.port、spring.redis.database 分开配，SSL 用 spring.redis.ssl.enabled=true 控制。
