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

本文深入解析了在Spring Boot项目中彻底关闭Redis自动配置的完整方案，强调仅排除`RedisAutoConfiguration`远远不够——必须同步排除强依赖`redisTemplate`的`RedisRepositoriesAutoConfiguration`，否则仍会因Bean缺失导致启动失败；同时详述了`@SpringBootApplication(exclude=...)`的正确语法（需Class数组、全限定名、准确import）、配置文件中YAML/properties的精确写法（严防缩进与空格错误），并指出真正“彻底关闭”的关键在于系统性清理：不仅要禁用自动配置类，还需清除所有`spring.redis.*`属性、避免手动声明Redis连接工厂Bean，并警惕如Spring Session等间接依赖Redis的Starter带来的隐式触发风险，帮助开发者一次性根除Redis相关启动异常和运行时连接问题。

必须同时排除 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学习网公众号吧！