Spring Boot重启时Redis连接池大量创建新连接,根本原因是Lettuce ClientResources未共享导致EventLoopGroup重复创建、Bean定义不规范绕过连接池、以及未启用优雅关闭致TIME_WAIT堆积。

Spring Boot服务重启时Redis连接池大量创建新连接,根本不是“重启本身”导致的,而是连接池未被正确复用、或旧连接未优雅关闭引发的资源残留和重复初始化。
应用重启时Lettuce ClientResources未共享
Lettuce底层依赖Netty的ClientResources管理线程池(EventLoopGroup)、DNS解析器、定时器等全局资源。如果每次重启都新建RedisClient或LettuceConnectionFactory且未复用同一份ClientResources,就会重复创建Netty线程组——表现为线程数暴涨,同时伴随大量TIME_WAIT连接。
- 典型错误:在
@Bean中直接new RedisClient(),或多次调用LettuceClientConfiguration.builder().build()生成独立配置 - 正确做法:将
ClientResources声明为@Bean并注入到所有LettuceConnectionFactory中 - 验证方式:dump线程栈,搜索
io.netty.channel.nio.NioEventLoop,若出现多个同名线程组即为泄漏
RedisTemplate或LettuceConnectionFactory Bean定义不规范
Spring Boot自动配置仅在满足条件时生效;手动定义Bean时若遗漏关键配置,会导致连接池被绕过,退化为短连接模式。
- 常见疏漏:
@Bean定义RedisTemplate时未传入已配置好的RedisConnectionFactory,或工厂本身是每次new出来的实例 - 后果:每次调用
redisTemplate.opsForValue().get()都可能触发getRedisConnection(),而该方法若拿到的是非池化连接,就等于每次执行都建一个TCP连接 - 检查点:确认
RedisConnectionFactoryBean是否单例、是否启用了连接池(isPoolEnabled() == true)
应用未等待连接池优雅关闭就退出
Spring Boot默认不等待Lettuce连接池关闭完成就结束进程,导致连接处于FIN_WAIT2或TIME_WAIT状态,端口无法立即复用,下一次启动又申请新端口,短时间内耗尽本地端口范围(32768–65535)。
- 表现:重启后
netstat -an | grep :6379 | grep TIME_WAIT数量激增 - 修复手段:在
application.yml中启用优雅关闭,并确保LettuceConnectionFactory能响应关闭信号 - 关键配置:
spring.redis.lettuce.shutdown-timeout=3000(单位毫秒),配合factory.setValidateConnection(true) - 注意:若使用K8s,还需配置
terminationGracePeriodSeconds大于该值,否则Pod强制终止会跳过关闭流程
最易被忽略的是:连接池参数(如max-active)在Spring Boot 3.x中必须写成spring.data.redis.lettuce.pool.max-active,旧路径spring.redis.lettuce.pool已失效——配置不生效,连接池实际大小为默认的8,高并发下瞬间打满,被迫不断新建连接。











