怎么利用 Spring 的 MergedBeanDefinition 深入理解 Bean 实例化前后的属性合并与覆盖机制

星瑶大大_5315

星瑶大大_5315

2026-04-15

726人浏览

原创

getmergedlocalbeandefinition 是合并入口,每次调用均现场执行递归合并,非读取缓存;mergedbeandefinitions 仅为弱缓存且易失效;合并发生在 getbean、getbeannamesfortype、preinstantiatesingletons、docreatebean 等多节点;childbeandefinition 需继承父定义并最终生成 rootbeandefinition。

怎么利用 spring 的 mergedbeandefinition 深入理解 bean 实例化前后的属性合并与覆盖机制

getMergedLocalBeanDefinition 是合并入口,不是缓存读取

调用 getBean("userService") 时,Spring 并不会直接从某个“合并缓存”里拿现成的 RootBeanDefinition。它每次都会调用 getMergedLocalBeanDefinition(beanName),现场执行合并逻辑:先取子定义(如 ChildBeanDefinition),再递归取父定义(parent="baseService" 指向的那个),最后把父的属性逐个复制、再用子的同名属性覆盖。

常见误解是认为合并只做一次、结果被长期缓存。实际上:mergedBeanDefinitions 这个 Map 只是弱缓存(key 是 beanName,value 是合并后结果),但缓存失效很频繁——比如你调用 registerBeanDefinition("c", newChildBeanDefinition("p")) 覆盖了原定义,下一次 getMergedLocalBeanDefinition("c") 就会重新合并。

  • 父定义必须已注册,否则抛 BeanDefinitionStoreException: Parent name 'xxx' is invalid
  • 抽象父定义(abstract="true")不能被直接 getBean,但可以被继承;若子定义没覆盖必要属性(如 class),合并后仍缺 class,实例化时抛 BeanInstantiationException
  • 合并不检查 Java 类型兼容性——parent 指向一个 BaseService,子定义设 class="UserService",Spring 不验证 UserService 是否继承 BaseService

merge 发生在多个关键节点,不止 getBean 时

合并不是只在 getBean() 时触发。它在 Spring 生命周期多个环节被主动拉起:

  • getBeanNamesForType(Class> type) 内部调用 doGetBeanNamesForType(),会先对所有 beanDefinitionNames 执行一遍 getMergedLocalBeanDefinition(),确保按合并后的类型匹配(否则 parent="baseService" 的子 Bean 可能被漏掉)
  • preInstantiateSingletons() 启动预实例化前,遍历所有单例 beanName,对每个都调一次 getMergedLocalBeanDefinition()
  • doCreateBean() 开始实例化前,再次调用该方法获取最终 RootBeanDefinition,此时还可能被 MergedBeanDefinitionPostProcessor 修改(如 AutowiredAnnotationBeanPostProcessor 会往 mbd 里塞 autowireCandidate 标记)

这意味着:你改了一个父 Bean 的属性,所有继承它的子 Bean 在下次触发上述任一操作时,都会拿到新合并的结果——不是热更新,但也不是静态快照。

ChildBeanDefinition 和 RootBeanDefinition 的行为差异

ChildBeanDefinition 本身不包含完整信息,它只存自己声明的属性和 parentName;而 RootBeanDefinition 是合并终点,可直接用于实例化。注意几个关键点:

  • ChildBeanDefinition 的 scope、lazyInit、abstract 等布尔/枚举属性,若未显式设置,则继承父定义值;但 beanClass、constructorArgumentValues、propertyValues 这三类必须由子定义提供或继承自父定义——没有默认值
  • 父定义是 RootBeanDefinition,子定义是 ChildBeanDefinition,合并结果一定是 RootBeanDefinition;但如果父定义也是 ChildBeanDefinition(即多级继承),合并会递归向上,直到触达顶层 RootBeanDefinition
  • 子定义中 propertyValues 若含同名 key(如都设了 version),子值无条件覆盖父值;但若父有 version=1.0,子没设 version,则保留 1.0

调试合并过程最有效的断点位置

想亲眼看到合并怎么一步步发生,不要埋点在 getBean(),直接打在:

  • AbstractBeanFactory.getMergedLocalBeanDefinition(String) —— 进入合并主逻辑
  • AbstractBeanDefinition.mergeAttributes(BeanDefinition) —— 真正执行属性复制与覆盖的私有方法,能看到 source(父)、target(子)如何逐字段处理
  • ConfigurationClassBeanDefinitionReader.loadBeanDefinitionsForBeanMethod() —— 如果你用 @Bean 方法定义父子关系(如 @Bean @Scope("prototype") BaseService baseService()),这里会生成带 parentName 的 ChildBeanDefinition

合并逻辑本身不复杂,但嵌套调用深、分支多。真正容易出问题的不是合并算法,而是父定义缺失、子定义漏写 class、或在 MergedBeanDefinitionPostProcessor 中误改了 mbd 的不可变字段(如 mbd.setBeanClass(null) 导致后续空指针)——这些错误往往在实例化阶段才暴露,回溯时得从合并入口开始查。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2471

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

457

25

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

2026.10.10

40

15

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

2026.10.10

20

15

Kratos框架Protobuf接口定义与代码生成合集
Kratos框架Protobuf接口定义与代码生成合集

本专题讲解Kratos框架接口定义体系,涵盖proto编写规范、proto add/client/server生成命令、http注解路由、validate校验、OpenAPI文档生成、跨服务proto复用与兼容性设计。

2026.10.10

0

15

C++虚函数怎么定义和调用
C++虚函数怎么定义和调用

C++虚函数是实现运行时多态的重要机制。本专题从virtual关键字的基本用法入手,介绍基类与派生类之间的函数重写、基类指针调用派生类方法,以及动态绑定的执行过程,帮助初学者掌握虚函数的核心语法。

2026.10.10

20

26

C++类与对象的封装方法教程
C++类与对象的封装方法教程

C++封装是面向对象编程的核心特性之一,通过类将数据与操作数据的函数组织在一起,并利用访问权限控制外部访问。本专题介绍类的定义、成员变量、成员函数以及public、private和protected的使用方法,帮助初学者掌握封装的基本原理。

2026.10.10

20

32

C++构造函数定义与调用方法
C++构造函数定义与调用方法

C++构造函数用于初始化类对象,是面向对象编程的重要基础。本专题从构造函数的定义、声明和调用入手,介绍默认构造函数、带参数构造函数、拷贝构造函数及成员初始化列表,帮助初学者掌握对象创建与初始化的基本方法。

2026.10.10

20

16

Kratos框架零基础入门教程
Kratos框架零基础入门教程

本专题整理Kratos框架入门内容,涵盖Go环境准备、kratos CLI安装升级、new命令创建项目、目录结构分层说明、服务启动与双协议端口、依赖下载报错排查,帮助开发者快速跑通第一个Kratos框架微服务应用。

2026.10.10

20

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.4万人学习