技术栈:Spring Boot
适用场景:多环境配置差异排查 + Spring Bean 初始化时机
1. 问题背景
项目是一个基于 Spring Boot 的物联网后台,配置按环境拆成了几份:application.yml 放公共内容,application-dev.yml、application-local.yml、application-pro.yml 各自负责环境差异。
MQTT 客户端由独立的通信子模块提供,逻辑本身不复杂:
MqttProperties绑定配置前缀mqttMqttCondition读mqtt.isOpen,决定要不要装配MqttConfig里的@Bean方法在初始化时调用mqttClientUtils.connect(),把连接建起来
正常启动时,控制台会打出这样一串日志:
text
=====================初始化MQTT客户端,尝试建立MQTT连接=====================
已成功连接到MQTT服务器,客户端ID: ...
MQTT客户端首次连接到服务器:tcp://...:1883
成功订阅MQTT主题: client/device/#
然后出了问题。dev 环境跑得好好的,切到 local 之后这串日志整段消失,设备数据也收不到。可 application-local.yml 里 mqtt.isOpen: true 写得清清楚楚,mqtt.hostUrl 也填好了,配置看着一点毛病没有。
2. 现象
用 local profile 启动,控制台干干净净,一行 MQTT 相关的输出都没有。业务侧确认设备上报的数据收不到,但应用本身启动成功,没有任何报错。
这里有个容易把人带偏的细节:没有报错。如果 Broker 连不上,正常应该抛异常,日志里能看到堆栈。现在是彻底安静,连失败都没有。
一开始怀疑的方向无非是几件事:profile 有没有真正生效、mqtt.isOpen 是不是被别的地方覆盖了、Broker 地址有没有填错。逐条确认下来全都没问题。最后才注意到一个起初没太在意的配置,local 环境里开了 Spring 的全局懒加载。
3. 排查过程
3.1 确认 profile 生效
application.yml 里默认指向 pro,跑 local 得显式指定 --spring.profiles.active=local,或者在 IDE 的 Run Configuration 里配好。翻启动日志确认过,跑的确实是 local。
3.2 确认条件装配
MqttCondition 的逻辑很直白,读配置值转布尔:
java
Environment environment = context.getEnvironment();
String isOpen = environment.getProperty("mqtt.isOpen");
return Boolean.valueOf(isOpen);
local 配置里 mqtt.isOpen 是 true,条件能过,不是这里的问题。
3.3 对比两份配置
dev 和 local 在 MQTT 相关字段上完全对齐,唯一的差异是 local 多了这段:
yaml
spring:
main:
# 开启懒加载,加快启动速度
lazy-initialization: true
到这里,问题的方向就清楚了。
4. 根因
MqttConfig 的写法大概是这样:
java
@Configuration
public class MqttConfig {
@Autowired
private MqttClientUtils mqttClientUtils;
@Conditional(MqttCondition.class)
@Bean
public MqttClientUtils getMqttClientUtils() {
log.info("初始化MQTT客户端,尝试建立MQTT连接");
mqttClientUtils.connect();
return mqttClientUtils;
}
}
连接动作写在 @Bean 方法体里,Bean 被创建的时候顺便把连接建起来。换句话说,连接建不建,取决于这个方法有没有被调用。
默认情况下,Spring Boot 启动时会把所有非 @Lazy 的 Bean 都创建好,getMqttClientUtils() 在启动阶段一定会执行,MQTT 连接也就一定连上。
打开 spring.main.lazy-initialization=true 之后规则变了。所有 Bean 都变成懒加载,只有第一次真正被用到才会初始化。如果启动过程和后续请求链路里没有任何地方直接依赖 MqttClientUtils,这个 Bean 就一直不会被创建,@Bean 方法体里那行 connect() 也就一次都不会执行。
所以表现出来的现象是 MQTT 没连上,实际情况是压根没走到连接那行代码。不是连接失败,是初始化根本没发生。这也解释了日志为什么一片空白,不是打了错误没人看,而是连日志都还没轮到打。
这段代码本身还有个值得说的地方。MqttConfig 用 @Autowired 注入了 MqttClientUtils,@Bean 方法又返回同一个类型,等于配置类产出的 Bean 正好是它自己需要的 Bean。这种自注入在 eager 模式下靠 Spring 的提前引用能糊过去,读代码的人却很难第一眼看明白连接究竟在什么时候发生。它把副作用藏在了 Bean 创建过程里,Bean 不被创建就什么都不会发生,这恰好是懒加载下最难查的一种失效。
5. 解决方式
最直接的做法是把 local 里的全局懒加载去掉:
yaml
# 删除这段
spring:
main:
lazy-initialization: true
然后以 application-dev.yml 为基准,对齐一下 local 的配置结构,只保留真正的环境差异,比如端口、数据库地址、Broker 地址,公共部分尽量保持一份。改完重启,MQTT 初始化日志重新出现,设备数据上报也恢复了。
6. 改动清单与回归验证
| 文件 | 改动 |
|---|---|
application-local.yml |
删除 spring.main.lazy-initialization |
application-local.yml |
以 dev 为基准对齐配置结构,只留环境差异项 |
验证盯两件事就够:启动日志里那四行 MQTT 初始化输出有没有重新出现,设备上报的数据能不能在平台上查到。两个都对上,问题就算闭环。
7. 全局懒加载的取舍
spring.main.lazy-initialization=true 不是坏东西。Bean 数量极多、冷启动时间卡得很死的场景,比如函数计算,开它确实有用,启动时间能明显缩短,启动阶段的资源压力也小。
但常规的后台业务系统里,这个开关有几个容易踩到的坑。
(1)健康状态变得不可预期。 应用显示启动成功,不再代表 MQ、MQTT、Redis 这些基础设施已经就绪,它们可能连初始化都还没开始。
(2)故障从启动时挪到了运行时。 Broker 连不上本来应该在启动阶段就炸掉,问题暴露得早,定位也快。懒加载把这个失败推到第一次真正用到的时候,可能是上线很久之后才在某个特定请求上冒出来。
(3)日志的迷惑性很强。 大家都习惯在启动日志里找初始化成功或失败的字样。懒加载下 Bean 没被用到,这些日志压根不出现,看起来跟正常运行没什么区别,其实什么都没发生。
(4)跟条件装配叠在一起更绕。 @Conditional、事件监听这类本来就有条件逻辑的机制,再叠一层懒加载,很容易出现条件明明满足、但没人访问、Bean 始终没被创建的情况,排查链路会被拉长一截。
如果确实有性能需求,稳妥的做法是只给那些不需要启动即初始化的 Bean 单独加 @Lazy,MQ、MQTT、数据库连接池、定时任务调度这些保持 eager。真要全局开,至少补一个 ApplicationRunner,在启动后显式触发关键 Bean 的初始化,把自检做上。
8. 小结
遇到某个模块在 A 环境有日志、B 环境没日志这类问题,可以按这个顺序排:先确认 profile 真的生效,再对比两个环境的配置差异,重点看会影响 Bean 初始化时机的配置,懒加载和条件装配都算。还定位不到,就在 @Bean 方法或 @PostConstruct 里加临时日志,确认初始化调用链到底有没有走到。
全局懒加载放在常规业务系统里,更像是一个把所有问题统一往后拖的开关。开之前先想清楚,哪些东西可以晚点初始化,哪些必须在启动时就 fail fast。