Spring @Import 注解详解

`@Import` 是 Spring 原生核心注解，并非 Spring Boot 专属，但在 Spring Boot 中被广泛应用（如自动配置、自定义组件装配），核心作用是：主动向 Spring 容器中导入指定的类，并将其注册为 Bean，无需再给这些类添加 `@Component`、`@Service`、`@Configuration` 等注册注解。

简单理解：Spring 容器默认扫描的是当前包及子包下带特定注解的类，而 `@Import` 可以突破扫描范围限制，直接“手动导入”任意类到容器中，实现灵活的 Bean 注册。

一、核心用途（Spring Boot 常用场景）

• 导入普通类，将其注册为 Spring Bean（无需加 @Component）；

• 导入配置类（带 @Configuration 的类），复用其他配置类中的 Bean 定义；

• 配合 Spring Boot 自动配置，导入自动配置类（如 @Import(AutoConfigurationImportSelector.class)，是 Spring Boot 自动配置的核心机制）；

• 导入 ImportSelector/ImportBeanDefinitionRegistrar 实现类，实现动态、批量导入 Bean（高级用法）。

二、常用用法（分场景示例）

场景1：导入普通类（最基础用法）

无需给普通类加 @Component，通过 @Import 直接导入，即可成为 Spring 容器中的 Bean。

// 普通类（无任何注册注解）
public class UserService {
    public void sayHello() {
        System.out.println("Hello, @Import!");
    }
}

// 配置类，导入 UserService
import org.springframework.context.annotation.Import;
import org.springframework.context.annotation.Configuration;

@Configuration
@Import(UserService.class) // 导入普通类，注册为Bean
public class AppConfig {
    // 无需额外定义 UserService 的 Bean，@Import 已完成注册
}

// 测试使用
public class Test {
    public static void main(String[] args) {
        ApplicationContext context = new AnnotationConfigApplicationContext(AppConfig.class);
        UserService userService = context.getBean(UserService.class);
        userService.sayHello(); // 正常执行，说明 Bean 已注册
    }
}

场景2：导入配置类（复用配置）

当需要复用其他配置类（如第三方配置、拆分的配置类）时，用 @Import 导入，无需扫描该配置类所在包。

// 另一个配置类（可能在其他包，未被默认扫描）
@Configuration
public class DbConfig {
    @Bean
    public DataSource dataSource() {
        // 配置数据源，省略具体实现
        return new DruidDataSource();
    }
}

// 主配置类，导入 DbConfig，复用其中的 DataSource Bean
@Configuration
@Import(DbConfig.class) // 导入配置类，其内部的 @Bean 会被注册到容器
public class AppConfig {
    // 可直接注入 DbConfig 中的 DataSource
    @Autowired
    private DataSource dataSource;
}

场景3：导入多个类（批量导入）

通过数组形式，一次性导入多个类（普通类、配置类均可）。

@Configuration
// 批量导入 UserService、DbConfig、OrderService 三个类
@Import({UserService.class, DbConfig.class, OrderService.class})
public class AppConfig {
    // 三个类对应的 Bean 均会被注册到容器
}

场景4：高级用法（动态导入）

导入 ImportSelector 实现类，实现“根据条件动态导入”（Spring Boot 自动配置核心原理），适用于复杂场景。

// 1. 实现 ImportSelector 接口，自定义导入逻辑
public class MyImportSelector implements ImportSelector {
    // 返回要导入的类的全限定名数组
    @Override
    public String[] selectImports(AnnotationMetadata importingClassMetadata) {
        // 可根据业务逻辑动态判断导入哪些类
        return new String[]{"com.example.UserService", "com.example.DbConfig"};
    }
}

// 2. 导入该 ImportSelector 实现类
@Configuration
@Import(MyImportSelector.class) // 动态导入指定类
public class AppConfig {
    // UserService、DbConfig 会被动态导入并注册为 Bean
}

三、关键注意事项

• @Import 导入的类，无论是否带有 @Component、@Configuration 等注解，都会被 Spring 容器注册为 Bean；若导入的是配置类（带 @Configuration），其内部的 @Bean 定义也会被一并注册。

• @Import 可用于任意带有 @Configuration 的配置类、主启动类（Spring Boot 主启动类本身就是一个配置类），但不能用于普通 Bean 类上。

• Spring Boot 中，@Import 常与 @Conditional 系列注解（如 @ConditionalOnProperty）配合使用，实现“条件导入”，按需注册 Bean（如自动配置中根据配置决定是否导入某个配置类）。

• 导入普通类时，Spring 会默认使用该类的无参构造方法创建 Bean（若没有无参构造方法，会报错）；若需自定义 Bean 的创建逻辑，可搭配 @Bean 注解。

• 与 @ComponentScan 的区别：@ComponentScan 是“被动扫描”指定包下的 Bean，@Import 是“主动导入”指定类，二者可配合使用，互补不足。

四、Spring Boot 中的实际应用（重点）

Spring Boot 的自动配置核心就是 @Import，最典型的就是主启动类上的 @SpringBootApplication 注解，其内部包含：

@SpringBootConfiguration
@EnableAutoConfiguration // 核心注解
@ComponentScan(...)

// @EnableAutoConfiguration 内部又包含：
@Import(AutoConfigurationImportSelector.class)

AutoConfigurationImportSelector 会动态扫描 Spring Boot 内置的自动配置类（如 RedisAutoConfiguration、DataSourceAutoConfiguration），并根据配置文件中的条件，自动导入并注册对应的 Bean，这也是 Spring Boot“自动配置”的核心原理。

五、总结

1. 核心作用：主动向 Spring 容器导入指定类，注册为 Bean，突破默认扫描范围限制；

2. 常用场景：导入普通类、复用配置类、动态批量导入、Spring Boot 自动配置；

3. 核心优势：灵活、高效，是 Spring Boot 中实现 Bean 装配的重要方式，尤其在自动配置和自定义组件中高频使用。