在 Spring 框架中，传统的 Bean 管理依赖于 applicationContext.xml 等 XML 配置文件。随着 Spring 对注解和 Java 配置的支持日益完善，基于 Java 的配置方式已成为主流。其中，@Configuration 注解是实现这一转变的核心。
一、什么是 @Configuration？
被 @Configuration 标注的类，会被 Spring 的 IOC 容器识别为一个配置类（Configuration Class），其作用等同于一个 XML 配置文件。在这个类中，你可以通过 @Bean 方法声明并注册 Spring 容器管理的 Bean。
示例：定义配置类
@Configuration public class ConfigurationDemo { @Bean public Date currentDate() { return new Date(); } }
✅ 上述代码等价于以下 XML 配置：
<bean id="currentDate" class="java.util.Date"/>
- 方法名
currentDate默认作为 Bean 的名称（id）； - 返回值对象由 Spring 容器管理，具备单例、依赖注入等特性。
二、启动基于 Java 配置的 IOC 容器
使用 AnnotationConfigApplicationContext 加载配置类，即可初始化 Spring 容器：
public class MainApp { public static void main(String[] args) { // 加载 ConfigurationDemo 配置类 AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(ConfigurationDemo.class); // 打印容器中所有 Bean 的名称 String[] beanNames = ctx.getBeanDefinitionNames(); Arrays.stream(beanNames).forEach(System.out::println); } }
输出结果：
org.springframework.context.annotation.internalConfigurationAnnotationProcessor org.springframework.context.annotation.internalAutowiredAnnotationProcessor org.springframework.context.annotation.internalCommonAnnotationProcessor org.springframework.context.event.internalEventListenerProcessor org.springframework.context.event.internalEventListenerFactory configurationDemo currentDate
🔍 关键说明：
configurationDemo：配置类本身的 Bean（默认首字母小写）；currentDate：通过@Bean方法注册的自定义 Bean；- 其余为 Spring 内部自动注册的后处理器（如处理
@Autowired、@EventListener等）。
三、@Configuration 的核心特性
- 替代 XML 配置
无需编写<beans>文件，全部配置通过 Java 代码完成，类型安全、易于重构。 - 支持依赖注入与方法调用
在配置类内部，可通过方法调用实现 Bean 之间的依赖关系（得益于 CGLIB 代理）：
@Configuration public class AppConfig { @Bean public UserService userService() { return new UserService(userRepository()); // 直接调用另一个 @Bean 方法 } @Bean public UserRepository userRepository() { return new UserRepository(); } }
⚠️ 注意：这种调用会经过 Spring 代理，确保返回的是容器中的单例 Bean，而非新实例。
- 可组合与导入
使用@Import可将多个配置类组合：
@Configuration @Import({DatabaseConfig.class, WebConfig.class}) public class RootConfig { }
- 与组件扫描结合
配合@ComponentScan，可同时管理配置类和注解驱动的组件（如@Service、@Repository）：
@Configuration @ComponentScan("com.example.service") public class AppConfig { }
四、最佳实践建议
- 命名规范：配置类建议以
Config或Configuration结尾，如DataSourceConfig； - 职责单一：按功能拆分配置类（如数据库、缓存、Web），避免“上帝配置类”；
- 优先使用 Java 配置：相比 XML，Java 配置更安全、可调试、支持 IDE 自动补全；
- 避免在
@Bean方法中使用new外部依赖：应通过参数注入或调用其他@Bean方法获取依赖。
总结
@Configuration 是 Spring 实现“无 XML”配置的关键注解。它让开发者能够以类型安全、结构清晰、易于维护的方式构建 Spring 应用上下文。结合 @Bean、@Import、@ComponentScan 等注解，你可以完全告别 XML，拥抱现代化的 Spring 开发体验。
