ImportSelector 通过 selectImports 方法在配置类解析早期返回第三方@Configuration类全限定名，由Spring自动注册；需结合ClassUtils.isPresent和AnnotationMetadata实现条件判断，并配合自定义注解与@Conditional完成分层条件控制。
Spring 中通过 ImportSelector 动态加载第三方配置类，核心在于让 Spring 容器在启动时根据条件（如环境、依赖、配置项等）决定是否引入某个外部的 @Configuration 类。它不直接实例化 Bean，而是返回一组全限定类名字符串，由 Spring 自动解析并注册为配置类。
理解 ImportSelector 的作用时机
ImportSelector 是一个接口，其 selectImports(AnnotationMetadata) 方法会在 @Configuration 类被处理的早期阶段（即解析 @Import 时）被调用。此时 Spring 还未开始创建 Bean，但已读取了当前配置类的注解元数据，可用于判断上下文信息。
- 返回的字符串数组必须是有效的、可被 Spring 加载的
@Configuration类的全限定名 - 这些类会被当作普通配置类参与 Spring 的配置类解析流程（支持
@Bean、@Import、@Conditional等） - 适合封装“是否启用某套第三方集成”的逻辑，比如按 profile 加载不同 SDK 的自动配置
编写自定义 ImportSelector 实现类
以动态加载某云服务 SDK 的配置为例（假设该 SDK 提供了 AliyunOssAutoConfiguration）：
public class CloudSdkImportSelector implements ImportSelector {
@Override
public String[] selectImports(AnnotationMetadata importingClassMetadata) {
// 检查是否引入了对应依赖（避免 ClassNotFound）
if (ClassUtils.isPresent("com.aliyun.oss.OSSClient", getClass().getClassLoader())) {
// 检查配置是否开启
if (isCloudEnabled(importingClassMetadata)) {
return new String[]{AliyunOssAutoConfiguration.class.getName()};
}
}
return new String[0]; // 不加载任何配置类
}
private boolean isCloudEnabled(AnnotationMetadata metadata) {
// 可从 Environment 或元数据中提取属性，例如：
// @EnableCloudSdk(enabled = true)
Map<String, Object> attrs = metadata.getAnnotationAttributes(EnableCloudSdk.class.getName());
return attrs != null && (Boolean) attrs.get("enabled");
}
}
注意：ClassUtils.isPresent() 能安全判断类是否存在，避免因缺失 jar 导致启动失败；AnnotationMetadata 可用于读取自定义注解上的参数，增强灵活性。
立即学习“Java免费学习笔记（深入）”；
配合自定义注解使用更清晰
封装一个注解，把 @Import 和选择逻辑收口起来：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Import(CloudSdkImportSelector.class)
public @interface EnableCloudSdk {
boolean enabled() default true;
String[] services() default {};
}
然后在主配置类上直接使用：
@Configuration
@EnableCloudSdk(enabled = true, services = {"oss"})
public class AppConfig {
}
这样使用者无需关心底层机制，只需声明注解即可触发条件化加载。
与 Condition 配合实现细粒度控制
如果第三方配置类本身也需条件化生效（比如只在 prod 环境加载），可在目标配置类上加 @ConditionalOnProperty 或自定义 @Conditional：
@Configuration
@ConditionalOnProperty(name = "cloud.oss.enabled", havingValue = "true")
public class AliyunOssAutoConfiguration {
@Bean
public OSS ossClient() {
return new OSSClientBuilder().build(...);
}
}
此时 ImportSelector 负责“是否把该类纳入扫描范围”，而 @Conditional 决定“该类中的 Bean 是否真正注册”，二者分工明确，组合使用更稳健。
