SpringBoot整合Redis缓存与连接池设置

本文深入剖析了Spring Boot集成Redis缓存时的三大核心痛点：连接池配置失效、缓存TTL不生效及云环境连接失败，并给出精准可落地的解决方案——必须显式通过LettuceClientConfigurationBuilder启用连接池，统一序列化器并启用key前缀以保障entryTtl生效，同时严格区分本地与云环境配置（如改用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 控制。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~