news 2026/5/17 6:59:48

@Configuration(Spring)详解让你懂它是什么、怎么用、常见坑与面试点

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
@Configuration(Spring)详解让你懂它是什么、怎么用、常见坑与面试点

总结:
@Configuration用来定义Java 配置类,用@Bean方法声明 Spring 管理的 Bean;Spring 会把它当作配置信息并用 CGLIB 动态代理(默认)处理,从而保证@Bean方法的单例语义与依赖注入正确。

下面分条讲清楚你必须掌握的点(配合例子和常见面试问答)。


1. 基本用法(最常见的场景)

@Configuration public class AppConfig { @Bean public UserService userService() { return new UserService(userRepository()); } @Bean public UserRepository userRepository() { return new UserRepository(); } }
  • AppConfig放到 Spring 上下文中(例如通过@SpringBootApplication的组件扫描,或手工AnnotationConfigApplicationContext(AppConfig.class)),Spring 会解析@Bean并注册对应的 Bean。
  • 默认@Bean的作用域是singleton

2.@Configuration@Component的区别

  • @Configuration本身带有@Component(因此可以被扫描),但它的语义比普通@Component更强:
  • @Configuration类会被 Spring 用 CGLIB 生成子类(代理),以保证同一配置类中@Bean方法相互调用时仍然返回容器管理的单例实例。
  • 如果你用@Component+@Bean(理论上也能),则不会有 proxy 的增强语义,互相调用会直接执行方法(可能导致重复实例化)。

3. 关键属性:proxyBeanMethods(Spring 5.2+)

@Configuration(proxyBeanMethods = true)默认(会生成代理,保证@Bean调用返回容器里同一个 bean)。
如果你把它设置为false,Spring 不会对配置类做 CGLIB 代理,性能更好但失去方法间调用的单例保证,适合配置类只是用作“工厂”且不同@Bean之间互不调用的场景(常见于 Spring Boot 的自动配置优化)。

示例说明差异:

@Configuration(proxyBeanMethods = true) // 或 false public class Config { @Bean public A a() { return new A(b()); } @Bean public B b() { return new B(); } }
  • proxyBeanMethods = truea()内部调用b()实际会走代理,返回容器中的B单例。
  • proxyBeanMethods = falsea()直接调用b()方法,返回的是新创建的 B 实例,会破坏单例语义。

4. 为什么需要 CGLIB 代理?(简要原理)

  • Spring 在解析@Configuration时,会把该类变成一个代理子类(CGLIB),当在配置类内调用b()时,调用会被拦截,代理去容器中取B(如果已存在),而不是直接在方法体内 new 一个新对象。
  • 因此不要把@Configuration类声明为final(CGLIB 需要继承)。

5. 常用组合与扩展

  • @Configuration常和以下注解一起使用:
    • @Bean:声明一个 bean。
    • @Import:引入其他配置类或配置组件。
    • @Profile:按环境条件激活配置。
    • @PropertySource:加载属性文件(但在 Spring Boot 中通常使用application.properties/yml)。
    • @Enable*(例如@EnableTransactionManagement)用于开启某些功能。
  • @ConfigurationProperties@Configuration不同:前者用于绑定配置属性。

6. Bean 生命周期与依赖注入风格

  • @Bean方法内部可以用构造器或者 setter 来注入依赖(示例里用 new 时手动传入)。
  • 也可以在@Bean方法参数中声明需要注入的其他 bean,Spring 会自动注入(更推荐):
@Bean public UserService userService(UserRepository repo) { return new UserService(repo); }

此方式可避免proxyBeanMethods的问题(因为注入在容器层面已完成)。


7. 常见坑 & 注意事项

  1. 不要把@Configuration类标记为final— CGLIB 代理需要继承。
  2. 如果@Configuration(proxyBeanMethods=false),切忌在同一类中互相调用@Bean方法(会创建多个实例)。
  3. 如果你只是把配置类当作“静态工厂”,并且@Bean互不依赖,可以用proxyBeanMethods=false提升性能(Spring Boot 的自动配置大量使用该优化)。
  4. @Configuration会被ConfigurationClassPostProcessor处理,发生在常规 bean 定义之前。
  5. 如果忘记导入配置类到上下文,@Bean不会生效(需要 component-scan、@Import 或在 ApplicationContext 注册)。
  6. @Bean方法不要写为private(Spring 需要能调用/代理)。

8. 面试常考简短问答(可背)

  • Q:@Configuration的作用?
    A: 声明 Java 配置类,里面用@Bean注册 Spring Bean;Spring 会对该类进行特殊处理(默认 proxyBeanMethods=true)。
  • Q:@Configuration@Component有什么不同?
    A:@Configuration会被 Spring 作为配置并生成代理以保证@Bean方法互调仍返回容器的唯一 Bean;@Component没有这些语义。
  • Q: 什么是proxyBeanMethods
    A: 控制是否对配置类做CGLIB 代理true(默认):保证方法间互调返回容器中的单例;false:不代理,性能更好但会失去方法调度保障。
  • Q:@Configuration类可以是final吗?
    A: 不应是final,因为默认是通过子类代理(CGLIB)。

9. 完整 runnable 示例(演示 proxyBeanMethods 的差异)

@Configuration(proxyBeanMethods = true) // 改成 false 看对比 public class DemoConfig { @Bean public ServiceA serviceA() { System.out.println("create ServiceA"); return new ServiceA(serviceB()); } @Bean public ServiceB serviceB() { System.out.println("create ServiceB"); return new ServiceB(); } } public class ServiceA { private final ServiceB b; public ServiceA(ServiceB b) { this.b = b; } } public class ServiceB { }
  • 启动AnnotationConfigApplicationContext(DemoConfig.class)
  • proxyBeanMethods = true:输出通常只会看到create ServiceB一次,ServiceB为单例。
  • proxyBeanMethods = false:可能会看到create ServiceB两次(serviceA()内部直接 new 的ServiceB与容器注册的ServiceB),造成重复实例。

10. 什么时候用@Configuration而不是 XML / 注解扫描?

  • 推荐在现代 Spring / Spring Boot 项目中使用@Configuration(类型安全、可重构、IDE 支持好)。XML 仅在需要兼容老系统或某些特殊场景时使用。
版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/14 18:57:16

PageHelper插件

介绍 PageHelper是第三方提供的Mybatis框架中的一款功能强大、方便易用的分页插件,支持任何形式的单标、多表的分页查询。 官网:Mybatis-PageHelper/wikis/zh/HowToUse.md at master ruiqianyi/Mybatis-PageHelper GitHub 代码实现 在pom.xml引入依…

作者头像 李华
网站建设 2026/5/16 20:26:47

苹果在日本突然“服软”,背后藏着一步大棋!

📌 目录17年封闭高墙被凿开!日本用户可自由装软件,苹果仍抽5%-21%:库克的合规躺赚套路玩疯了一、法律利剑高悬:20%营收罚款倒逼苹果妥协(一)法律硬约束:违者最高罚全年营收20%&#…

作者头像 李华
网站建设 2026/5/9 16:01:42

构建三重防线:软件测试外包质量控制体系实践指南

测试外包质量困境与破局思路 随着软件开发周期的不断压缩和成本控制压力的增加,测试外包已成为众多企业的战略选择。然而,测试外包项目普遍面临质量波动大、沟通成本高、交付物不规范三大痛点。2024年行业数据显示,超过60%的测试外包项目在首…

作者头像 李华
网站建设 2026/5/16 4:49:27

Apache Doris AI 能力揭秘(四):HSAP 一体化混合搜索与分析架构全解

AI 时代正在重塑数据库的角色。过去,数据库主要为人类分析者提供报表与查询能力;而现在,越来越多的查询来自智能代理(Agent),它们会自动检索知识、过滤数据、组合多种信号,并将数据库作为 “实时…

作者头像 李华