Spring Boot自定义库绑定测试依赖但主Jar排除方案咨询

如何避免下游Spring Boot项目引入自定义库的测试依赖 #

你之前的思路存在误区：移除test scope会让测试依赖升级为编译/运行时依赖，下游项目必然会继承这些依赖；而maven-surefire-plugin仅负责执行测试用例，不具备管理依赖scope的能力，所以在插件里设置完全无效。正确处理方式分两种场景：

场景1：自定义库仅自身测试需要这些依赖 #

这种情况完全不需要改动test scope，直接保持测试依赖的<scope>test</scope>配置即可。效果是：

• 自定义库执行自身测试时能正常调用这些依赖
• 下游Spring Boot项目引入你的库时，不会继承任何test scope的依赖，自然不会出现在主Jar的lib目录中

场景2：自定义库对外提供测试工具类（需依赖测试库） #

如果你的库包含供外部项目使用的测试工具（比如自定义测试基类、Mock工具），可以按以下方式处理：

1. 拆分模块：把测试相关工具类单独拆成子模块（例如your-library-test-support），在这个子模块中将测试依赖设为compile或provided；主模块（your-library-core）保持正常的test scope依赖。下游项目仅在需要测试工具时才引入your-library-test-support，主项目引入核心模块不会携带测试依赖。
2. 使用optional标记：若不想拆分模块，可在自定义库的测试依赖上添加<optional>true</optional>，示例：

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.10.1</version>
    <!-- 标记为可选，下游项目不会自动引入 -->
    <optional>true</optional>
</dependency>

这种配置下，自定义库自身能正常使用这些依赖，但下游项目需要用到时必须手动引入，不会被动添加到Fat Jar中。

不处理测试依赖引入的其他问题 #

除了Fat Jar体积变大，还会带来以下风险：

• 依赖冲突：测试依赖（如JUnit、Mockito）的版本可能与主项目依赖版本不一致，引发NoSuchMethodError、ClassNotFoundException等运行时异常
• 安全隐患：测试库通常不会像生产级依赖那样频繁更新漏洞修复，留在生产环境Jar中可能引入未被修复的安全漏洞
• 类路径污染：测试相关的类（如Mock框架的代理类、测试用Stub实现）可能被主项目错误加载，导致业务逻辑出现不可预期的行为
• 部署效率下降：更大的Jar包会增加上传、部署的时间，尤其是容器化部署场景下，镜像构建和推送的耗时都会显著增加

内容的提问来源于stack exchange，提问作者Nandlalaji Singh