本文介绍如何在 Spring Boot 中基于 application.properties 中的配置项，动态决定注入哪个服务实现类，从而实现运行时灵活切换业务逻辑。
本文介绍如何在 spring boot 中基于 `application.properties` 中的配置项，动态决定注入哪个服务实现类，从而实现运行时灵活切换业务逻辑。
在实际开发中，我们常需要根据环境或配置（如开发/测试/生产）切换不同实现——例如从文件读取人员数据（FilePersonService）或从数据库读取（DbPersonService）。Spring Boot 提供了强大的条件化 Bean 注册机制，无需手动判断或工厂模式即可优雅实现。
✅ 推荐方案：使用 @ConditionalOnProperty
为每个实现类添加 @ConditionalOnProperty 注解，使其仅在指定配置存在且值匹配时才被注册为 Spring Bean：
@Service
@ConditionalOnProperty(
name = "person.service.impl",
havingValue = "file"
)
public class FilePersonService implements IPersonService {
@Override
public List<person> readPersons() {
// 模拟从文件读取
return Arrays.asList(new Person("Alice"), new Person("Bob"));
}
}
@Service
@ConditionalOnProperty(
name = "person.service.impl",
havingValue = "db"
)
public class DbPersonService implements IPersonService {
private final PersonRepository repository;
public DbPersonService(PersonRepository repository) {
this.repository = repository;
}
@Override
public List<person> readPersons() {
return repository.findAll();
}
}</person></person>
⚠️ 注意：两个实现类不能同时满足条件，否则会因 NoUniqueBeanDefinitionException 启动失败。确保 person.service.impl 在 application.properties 中有且仅有一个合法值。
在 application.properties 中配置：
# 可选值：file 或 db person.service.impl=file # person.service.impl=db
控制器可直接依赖接口，Spring 会自动注入唯一符合条件的 Bean：
@RestController
@RequestMapping("/api")
public class PersonController {
private final IPersonService personService;
public PersonController(IPersonService personService) {
this.personService = personService; // 构造器注入更推荐
}
@GetMapping("/persons")
public List<person> readAllPersons() {
return personService.readPersons();
}
}</person>
? 补充说明与最佳实践
- 避免 @Autowired 字段注入：推荐使用构造器注入（如上），保证依赖不可变且便于单元测试。
-
默认实现支持：若希望某实现作为默认兜底（当配置缺失时启用），可添加 matchIfMissing = true：
@ConditionalOnProperty(name = "person.service.impl", havingValue = "file", matchIfMissing = true)
- 多环境配置建议：配合 spring.profiles.active 使用，例如在 application-dev.properties 中设 person.service.impl=file，在 application-prod.properties 中设 person.service.impl=db，进一步解耦环境策略。
通过 @ConditionalOnProperty，你无需编写任何工厂类或 @Configuration 条件逻辑，即可实现轻量、清晰、可测试的服务动态装配——这正是 Spring Boot “约定优于配置”理念的典型体现。
