必须同时排除 redisautoconfiguration 和 redisrepositoriesautoconfiguration,否则因后者依赖 redistemplate 而启动失败;exclude 参数需传入 class 数组,配置文件中须正确书写全限定名并避免缩进错误,且需清理残留 redis 属性和手动 bean。

必须同时排除 RedisAutoConfiguration 和 RedisRepositoriesAutoConfiguration,否则仍可能因 bean 依赖失败而启动报错。
为什么只 exclude RedisAutoConfiguration 不够
Spring Boot 的 RedisRepositoriesAutoConfiguration 会尝试注入名为 redisTemplate 的 bean;如果你只排除了 RedisAutoConfiguration,但没排除它,应用启动时就会抛 BeanCreationException: No qualifying bean of type 'RedisTemplate'。这不是配置遗漏,而是自动配置链的显式依赖关系。
-
RedisRepositoriesAutoConfiguration默认启用,只要 classpath 里有spring-boot-starter-data-redis和 Spring Data Redis 相关类 - 它不检查 Redis 是否真被使用,只看条件是否满足(比如是否有
RedisOperations类) - 即使你没写任何 Redis 相关代码,只要依赖存在,这个配置就可能触发
@SpringBootApplication(exclude=...) 的写法细节
在主启动类上使用 @SpringBootApplication 注解时,exclude 参数必须传入完整的 Class 对象数组,不能只写类名字符串或用通配符。
Redis 8.2.3 是一款安全优先的高性能键值存储系统。该版本紧急修复了可能引发远程代码执行(RCE)的高危漏洞(CVE-2025-62507),并解决了 HyperLogLog 及 Cuckoo Filter 等数据结构在特定场景下的崩溃问题。建议所有用户立即升级,以保障生产环境的系统稳定与数据安全。
- 正确写法:
@SpringBootApplication(exclude = {RedisAutoConfiguration.class, RedisRepositoriesAutoConfiguration.class}) - 错误写法:
@SpringBootApplication(exclude = "RedisAutoConfiguration")(字符串无效) - 错误写法:
@SpringBootApplication(exclude = RedisAutoConfiguration.class)(缺少花括号,Java 数组语法错误) - 注意包路径:两个类都在
org.springframework.boot.autoconfigure.data.redis下,确保 import 正确
application.yml 或 application.properties 中的等效配置
配置文件方式更灵活,适合多环境差异化控制,但要注意 YAML 的缩进和冒号后空格 —— 错一个空格就会导致配置失效,且无明确报错提示。
-
application.properties写法:spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration,org.springframework.boot.autoconfigure.data.redis.RedisRepositoriesAutoConfiguration -
application.yml写法:spring: autoconfigure: exclude: - org.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration - org.springframework.boot.autoconfigure.data.redis.RedisRepositoriesAutoConfiguration - 该配置必须放在
application.yml的顶层,不能嵌套在其他 key 下(例如不能写在spring: profiles:里)
排除后还报 Redis 连接相关错误?检查这些地方
即使自动配置已关闭,残留的 Redis 配置项仍可能触发底层连接初始化,尤其是当项目中残留了 spring.redis.* 属性时。
- 检查
application.yml或application.properties是否还有spring.redis.host、spring.redis.port等配置 —— 这些值不会被自动配置读取,但某些第三方 starter(如 Spring Session Redis)可能直接读取并尝试连接 - 确认没有手动声明
LettuceConnectionFactory或JedisConnectionFactorybean —— 它们会主动触发连接建立 - 如果用了
spring-session-data-redis,它自带 Redis 依赖逻辑,需额外排除:SessionAutoConfiguration或改用其他 session 存储方案 - 留意 IDE 缓存:修改配置后,Maven/Gradle 可能未刷新 classpath,建议 clean + rebuild
真正“彻底”关闭的关键不在排除动作本身,而在切断所有潜在触发点:自动配置类、配置属性、显式 bean 声明、以及间接依赖它的其他 starter。漏掉任意一环,都可能在某个冷路径下突然冒出 Redis 连接超时或拒绝连接异常。










