• SpringBoot自动装配坑了我一天原来问题出在这

SpringBoot 的自动装配是其主要特性之一，它通过约定比更好配置的原则极大简化开发。 只是这种“黑盒”便利往往变成开发者的“隐形陷阱”。 最近，我在一个项目中因为自动装配导致的错误耗费了整整一天时间才定位到根源。这篇文章复盘这次踩坑经历，原因，并给出避免类似问题的实践建议。

问题描述

场景还原

项目同时集成 Redis 与 MongoDB 两种数据源，配置如下：

spring:
data的观点是，redis:
host这方面，
port这方面。
mongodb:
至于uri，mongodb://localhost:/test

代码通过 @Autowired 注入对应模板：

@Autowired
private RedisTemplate redisTemplate;
@Autowired
private MongoTemplate mongoTemplate;

启动时抛出异常：

Field mongoTemplate in com.example.demo.service.MyService required a bean of type 'org.springframework.data.mongodb.core.MongoTemplate' that could not be found.

排查过程

1. 再看检查依赖，确认已引入 spring-boot-starter-data-mongodb
2. 从验证配置来看，MongoDB 连接字符串格式正确且服务可达
3. 调试启动这方面，发现 MongoAutoConfiguration 未生效
4. 至于对比测试，新建纯净项目可以正常注入 MongoTemplate

根本原因分析

自动装配条件约束失效

Dive into source reveals that MongoAutoConfiguration's activation depends on:

@ConditionalOnClass
@ConditionalOnMissingBean
public class MongoAutoConfiguration { ... }

The culprit was an indirect dependency introduced by Lettuce’s native transport:

io.lettuce
lettuce-core

Lettuce’s Netty native transport pulls in io.netty:netty‑transport‑native‑epoll,which unintentionally contains stub classes from MongoDB driver . This causes Spring Boot to think that MongoClient.class is present but fails to find its full implementation at runtime。leading Spring Boot to skip MongoDB auto‑configuration.

依赖冲突的隐蔽性与危害性

A dependency tree inspection reveals hidden path:

+ - io.lettuce:lettuce-core:jar:<>compile
+ - io.netty:netty-transport-native-epoll:jar:<><>compile
+ -

• The MongoDB driver is marked optional.
• The presence of its stub classes triggers conditional checks.
• The actual error surfaces only during runtime.
• Resulting pain point:: Lost entire day's debugging effort due to invisible transitive dependency..........

  短期修复 1️⃣ 在 application.properties 明确启用 MongoDB 自动配置 properties spring.data.mongodb.auto-index-creation=true 或 xml ... io.netty netty-transport-native-epoll

  长期建议 1️⃣ 规范化依赖管理 xml ` 2️⃣ 利用 Spring Boot 自动配置报告调试 运行 java -jar app.jar --debug 或 --spring.debug 可输出： MongoAutoConfiguration : Did not match : @ConditionalOnClass did not find required class 'com.mongodb.client.MongoClient' 3️⃣ 自定义诊断端点查看条件评估 java @Endpoint public class ConditionsEndpoint { @ReadOperation public Map conditions { return new ConditionEvaluationReportMessage( ConditionEvaluationReport.get).getConditions;} }