在Spring Boot项目中，默认推荐使用注解和Java配置类来定义Bean，但现实开发中经常会遇到需要复用原有基于xml的Spring配置文件的情况。借助@ImportResource注解，我们可以让Spring Boot启动时加载指定的xml文件，将其中的Bean注册到容器中。
@ImportResource注解基本用法
@ImportResource可以用在主启动类或任意配置类上，通过locations或value属性指定xml文件路径。容器启动后会解析这些文件并注册Bean。
@SpringBootApplication
@ImportResource(locations = {"classpath:spring-bean.xml"})
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
xml配置文件示例
假设我们有一个简单的xml配置文件，里面定义了一个服务类Bean：
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="userService" class="com.example.service.UserService">
<property name="name" value="test"/>
<!-- 定义Bean属性 -->
</bean>
</beans>
读取并使用xml中的Bean
加载完成后，就可以像普通Spring Bean一样通过@Autowired注入使用，无需额外操作。
@RestController
public class TestController {
@Autowired
private UserService userService;
@GetMapping("/name")
public String getName() {
return userService.getName();
}
}
@ImportResource常用参数说明
| 参数名 | 作用 |
|---|---|
| value | 等同于locations，指定xml文件路径数组 |
| locations | 指定需要导入的xml配置文件位置 |
| reader | 指定自定义的BeanDefinitionReader，一般无需设置 |
注意事项
- xml文件路径支持classpath:前缀，也支持文件绝对路径。
- 如果xml中使用了<context:component-scan>，需注意与Spring Boot扫描包范围不要冲突。
- @ImportResource只负责导入Bean定义，不会开启xml里的命名空间注解驱动，必要时需配合@Enable注解。
当项目逐步转向Java Config时，可先通过@ImportResource兼容旧xml，再逐步迁移，降低改造风险。
多文件导入写法
若有多个xml文件，可以用数组形式一次导入：
@ImportResource({
"classpath:spring-bean.xml",
"classpath:spring-datasource.xml"
})
@SpringBootApplication
public class DemoApplication {}
与@Configuration共存
@ImportResource和@Configuration配置类完全可以一起使用，Spring会合并所有来源的Bean定义，不会产生冲突。
Spring_BootImportResourcexml配置修改时间：2026-07-27 13:00:14