关闭Redis自动配置，彻底禁用AutoConfiguration

想要彻底关闭Spring Boot中的Redis自动配置？仅排除RedisAutoConfiguration远远不够——因为RedisRepositoriesAutoConfiguration会无条件依赖redisTemplate，一旦存在spring-boot-starter-data-redis依赖，它就会触发并导致BeanCreationException；必须同步排除这两个配置类，并严格遵循Java数组语法（如`exclude = {RedisAutoConfiguration.class, RedisRepositoriesAutoConfiguration.class}`），同时清理application.yml/.properties中所有`spring.redis.*`属性、删除手动声明的Redis连接工厂Bean，并警惕spring-session-data-redis等间接依赖带来的隐式连接尝试——真正的“彻底关闭”，是切断自动配置、配置项、显式Bean和第三方starter四重触发路径的完整闭环。

必须同时排除 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 对象数组，不能只写类名字符串或用通配符。

• 正确写法：@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 或 JedisConnectionFactory bean —— 它们会主动触发连接建立
• 如果用了 spring-session-data-redis，它自带 Redis 依赖逻辑，需额外排除：SessionAutoConfiguration 或改用其他 session 存储方案
• 留意 IDE 缓存：修改配置后，Maven/Gradle 可能未刷新 classpath，建议 clean + rebuild

真正“彻底”关闭的关键不在排除动作本身，而在切断所有潜在触发点：自动配置类、配置属性、显式 bean 声明、以及间接依赖它的其他 starter。漏掉任意一环，都可能在某个冷路径下突然冒出 Redis 连接超时或拒绝连接异常。

终于介绍完啦！小伙伴们，这篇关于《关闭Redis自动配置，彻底禁用AutoConfiguration》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布数据库相关知识，快来关注吧！