SpringBoot连接Redis配置教程

本文深入剖析了Spring Boot集成Redis缓存时的三大高频“踩坑点”：连接池失效（需显式通过LettuceClientConfigurationBuilder注入poolConfig，而非仅配置属性）、缓存项TTL不生效（根源常在于序列化器不统一或key前缀未启用导致元数据丢失），以及云环境连接失败（必须改用rediss://协议、清除URI路径、禁用SSL相关query参数，推荐分项配置主机、端口、数据库和SSL开关）。内容直击生产环境真实痛点，提供可立即落地的代码级解决方案与关键参数调优建议，助你避开90%以上Redis缓存配置陷阱。

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 控制。

今天关于《SpringBoot连接Redis配置教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！