Spring框架搭建：IoC与XML Bean装配教程

本文深入解析了在Spring 5.x与JDK 8环境下仍可使用的XML Bean装配方案——虽被官方标记为“legacy”且不再推荐用于新项目，但在维护遗留系统或教学演示中仍有现实价值；文章直击实践痛点，从版本锁定（Spring 5.3.37）、依赖精简（仅spring-context/spring-beans）、XSD地址校准、IDE配置技巧，到ClassPathXmlApplicationContext三大启动失败根源、构造注入与setter注入的本质区别、prototype作用域的真实行为，再到混合配置的隐性陷阱，层层拆解常见报错背后的底层逻辑，帮你避开踩坑雷区，真正掌握XML配置的可控边界与关键细节。

Spring 5.x + JDK 8 环境下，XML 配置方式已不推荐但依然可用

Spring 官方从 5.2 开始明确标记 ClassPathXmlApplicationContext 为“legacy”，不是不能用，而是新项目里硬上 XML 会卡在依赖、版本、IDE 支持三道坎上。如果你必须用（比如维护老系统、教学演示），核心是锁死版本组合：JDK 8 + Spring 5.3.37（最后一个支持 JDK 8 的 5.x 小版本）+ Maven 坐标不带 spring-boot-starter。

常见错误现象：java.lang.NoClassDefFoundError: org/springframework/core/metrics/ApplicationStartup —— 这是用了 Spring 6+ 的 JAR 却配了 JDK 8；org.xml.sax.SAXParseException: cvc-complex-type.2.4.c —— XML 命名空间写错或 XSD 地址失效。

• XML 文件头必须用 Spring 5.x 对应的 XSD：http://www.springframework.org/schema/beans/spring-beans-5.3.xsd，别抄网上过时的 3.0 或 4.0 地址
• Maven 里只引 spring-context 和 spring-beans，别加 spring-web 或 spring-boot 相关依赖，否则类路径污染导致 BeanFactory 初始化失败
• IDEA 默认不识别 applicationContext.xml，右键文件 → “Mark as Spring Config” 才能获得 bean 引用提示

ClassPathXmlApplicationContext 启动失败的三个高频原因

这个类看似简单，但初始化过程会静默跳过很多配置问题，直到你调 getBean() 才报错。最常卡在资源加载、解析、实例化三个阶段。

• XML 文件不在 src/main/resources 下，或名字没写对 —— new ClassPathXmlApplicationContext("app.xml") 会找 classpath 根目录下的 app.xml，不是当前包路径
• bean 的 class 属性写的是接口名（如 com.example.Service），而不是具体实现类（如 com.example.DefaultService），Spring 不会自动帮你猜实现
• 构造函数参数类型匹配失败：XML 里用 传字符串，但目标类构造器要的是 int，得显式写 type="int"，否则报 No matching factory method found

XML 中 和 到底怎么选

这不是风格问题，是对象生命周期和可测试性的分水岭。Spring 官方文档早就不鼓励 setter 注入（），因为会导致 bean 构造后处于不完整状态。

• 强制依赖（比如 Service 必须有 Dao）—— 用 ，Spring 会在构造时检查参数是否可解析，漏配直接启动失败
• 可选依赖（比如日志开关、回调监听器）—— 用 ，配合 autowire="byType" 或显式 ref，但注意 autowire 在 XML 中默认关闭
• 混合使用没问题，但别在一个 bean 定义里既写 又写 同名字段，Spring 会优先走构造注入，setter 被忽略且不报错

XML Bean 定义里 scope="prototype" 的真实行为

很多人以为 prototype 就是“每次 getBean 都新建”，但忽略了它只控制 Spring 容器内的实例数量，不干涉对象内部状态或线程安全。

• prototype bean 的构造函数会被多次执行，但它的依赖（比如一个 singleton dao）仍是共享的 —— 这点常被误认为“没生效”
• prototype bean 里的字段如果存了可变状态（如 List cache = new ArrayList<>()），多线程并发调用时会互相污染，Spring 不负责同步
• prototype bean 不会自动销毁：容器关闭时，只有 singleton bean 触发 destroy-method，prototype 的清理得你自己在业务代码里做

真正难搞的不是怎么写 XML，而是当团队里有人开始混用 JavaConfig（@Configuration）和 XML 时，@ImportResource 加载顺序、profile 激活条件、bean 名称冲突这些事，根本不会在编译期暴露。

终于介绍完啦！小伙伴们，这篇关于《Spring框架搭建：IoC与XML Bean装配教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！