场景

引入一个 Starter 后应用自动获得数据源或监控 Bean 很方便，但版本升级时也可能因类路径或配置变化加载了不同实现。

原理

自动装配从启动注解导入候选配置类，再依据类路径、已有 Bean、属性和 Web 类型等条件筛选。它遵循“用户定义优先”的退让原则：许多默认 Bean 只在容器中尚不存在同类对象时创建。

设计步骤

排查时先看依赖树和配置属性；开启条件评估报告，确认候选配置为何匹配或未匹配；检查 Bean 名称与类型覆盖；编写自定义 Starter 时拆分属性类、自动配置类和运行库，并用条件注解限定边界。

权衡

自动装配降低接入成本，也把部分决策推迟到运行时；条件越灵活，组合测试越复杂。强行覆盖默认 Bean 能快速解决问题，却可能依赖内部实现，在框架升级时失效。

实践建议

Starter 只提供合理默认值，不替业务做不可逆决定；属性设置前缀、默认值和校验，并生成配置元数据。使用 ApplicationContextRunner 测试有无依赖、不同属性和用户自定义 Bean 的组合。升级前比较条件报告，避免只看应用是否启动。

落地检查

上线前还应做一次桌面演练：准备正常、边界、超时、重复与恶意输入，确认系统的返回、日志和指标彼此对应；在预发布环境模拟依赖不可用、进程重启和配置回滚，验证降级路径不会放大故障。上线时采用小流量观察，提前定义停止条件与负责人。稳定后复盘真实数据，删除没有收益的复杂度，并把新发现的约束补进测试、监控和设计记录，使方案能够随业务持续演进，而不是停留在一次性评审结论。