使用 Reflections 库调用 getSubTypesOf() 时意外返回测试中定义的匿名子类，可通过配置 FilterBuilder.exclude() 过滤测试路径来精准扫描生产代码。
使用 reflections 库调用 `getsubtypesof()` 时意外返回测试中定义的匿名子类，可通过配置 `filterbuilder.exclude()` 过滤测试路径来精准扫描生产代码。
在基于 Java 的反射扫描场景中（例如自动发现所有实现了某个接口或继承了某个基类的组件），org.reflections.Reflections 是一个常用工具库。但其默认行为会扫描 classpath 下所有匹配包路径的类——包括编译后的测试类（如 target/test-classes/ 中的类）。当测试中存在类似 new BaseClass() {} 的匿名内部类定义时，getSubTypesOf(BaseClass.class) 就可能误将这些仅用于测试的、无实际业务意义的匿名类型纳入结果，导致逻辑异常、重复注册，甚至运行时 ClassCastException。
一个简洁可靠的解决方案是显式过滤掉测试相关的类路径。Reflections 提供了 FilterBuilder 机制，支持通过正则或前缀方式排除特定资源路径。以下为推荐用法：
import org.reflections.Reflections;
import org.reflections.scanners.Scanners;
import org.reflections.util.ConfigurationBuilder;
import org.reflections.util.FilterBuilder;
// 假设 BaseClass 是你的目标基类，myPackage 是需扫描的主包名（如 "com.example.service"）
String myPackage = "com.example.domain";
Set<Class<? extends BaseClass>> subTypes = new Reflections(
new ConfigurationBuilder()
.forPackages(myPackage)
.addScanners(Scanners.SubTypes) // 显式指定扫描器，提升准确性和性能
.filterInputsBy(new FilterBuilder()
.exclude(".*test.*") // 排除路径含 test 的类（覆盖 test/, Test, test-classes 等）
.exclude(".*\.class$") // 可选：进一步确保只处理类文件（非资源）
)
).getSubTypesOf(BaseClass.class);⚠️ 注意事项：
- exclude("test")（原答案写法）仅匹配字面量 "test"，无法覆盖 test-classes 或 MyTestClass 等常见命名；建议使用正则 ".*test.*" 更鲁棒；
- 若项目使用模块化结构（如多 module Maven），应确保 forPackages(...) 指向的是源码主包（非测试包），并确认该包下所有目标子类已正确编译至主 classpath；
- 在构建工具层面（如 Maven），也可通过 <excludes> 配置 maven-compiler-plugin 防止测试类参与主扫描，但反射层过滤更直接可控；
- 对于 Kotlin 项目，还需额外排除 Kt$ 后缀类（如 exclude(".*\$.*")），以防伴生对象生成的合成类干扰。
总结：无需修改测试代码或引入额外依赖，仅通过 ConfigurationBuilder.filterInputsBy() 即可实现安全、可维护的扫描隔离。这是 Reflections 库在真实工程中落地的关键实践之一。
