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

在Spring Boot项目中彻底关闭Redis自动配置并非简单排除一个类即可，必须同步排除`RedisAutoConfiguration`和`RedisRepositoriesAutoConfiguration`两个强依赖类，否则因后者对`redisTemplate`的硬性注入要求，应用仍会启动失败；同时需严格遵循`@SpringBootApplication(exclude = {...})`的Class数组语法、正确配置`spring.autoconfigure.exclude`的全限定类名（注意YAML缩进与properties格式）、清理所有`spring.redis.*`残留属性、移除手动声明的Redis连接工厂Bean，并警惕如Spring Session等间接依赖Redis的starter带来的隐式触发——唯有系统性切断自动配置、配置项、显式Bean及衍生依赖这四大路径，才能真正实现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学习网公众号！