运行时是否需API JAR？能否手动排除及相关库规范咨询

问题背景 #

我在项目中使用了slf4j-simple、simple-java-mail及其他依赖，通过IntelliJ查看Gradle的runtimeClasspath时发现：

• slf4j-api、jakarta-mail-api、jakarta-activation-api与其对应的实现JAR（slf4j-simple、jakarta-mail、jakarta-activation）同时出现在运行时路径中；
• slf4j-simple本身包含了slf4j-api，而slf4j-api原本是编译时依赖。

问题解答 #

1. 在build.gradle中通过exclusion手动移除所有API JAR是否安全？ #

不建议盲目手动排除所有API JAR，具体原因如下：

• 部分实现库仅可选内置API：比如slf4j-simple确实内置了slf4j-api，但jakarta-mail、jakarta-activation这类官方实现通常不会内置对应API，它们依赖API作为编译和运行的接口契约。盲目排除jakarta-mail-api可能直接导致编译或运行时出现类找不到的错误。
• 依赖传递的连锁影响：项目中其他第三方依赖可能直接依赖这些API JAR，手动排除可能破坏依赖链，引发隐性的类缺失问题。
• 可针对性排除重复：如果通过gradle dependencies命令确认某个实现库完全内置了对应API（比如slf4j-simple），且没有其他依赖需要单独的API JAR，此时可以针对性排除重复的API依赖，避免冗余，但不能一刀切排除所有。

2. 是否所有API JAR都不应出现在运行时？ #

不是，API JAR出现在运行时是正常且安全的：

• API JAR包含接口、抽象类和注解，是实现库必须遵守的契约，只要API与实现版本兼容，就不会和实现类产生冲突。
• Java类加载机制会优先加载实现类，API中的抽象定义仅作为调用契约存在，不会引发类重复加载问题（除非API和实现版本不兼容，比如方法签名不一致）。
• 部分框架或库在运行时需要读取API中的注解或元数据，此时API JAR必须存在于运行时路径中，否则会出现反射调用失败的问题。

3. 上述各库的相关规范说明 #

SLF4J系列

• slf4j-api：SLF4J的核心接口定义，所有SLF4J实现（包括slf4j-simple）都需遵循该接口规范。它的定位是编译时依赖，供业务代码调用统一的日志接口，屏蔽底层实现差异。
• slf4j-simple：SLF4J的极简日志实现，为简化使用，其J包内置了slf4j-api的类，因此单独引入slf4j-simple时无需额外引入slf4j-api。若项目中其他依赖也引入了slf4j-api，Gradle会自动处理版本冲突（默认选取最高兼容版本）。

Jakarta Mail & Activation系列

• jakarta-mail-api：Jakarta EE规范中定义邮件服务的标准接口，包含Session、Message等核心抽象类与接口，所有邮件实现（如jakarta-mail）都必须实现这些接口。
• jakarta-mail：jakarta-mail-api的官方参考实现，本身不包含API类，依赖jakarta-mail-api作为编译和运行时的接口契约。
• jakarta-activation-api：定义数据激活处理的标准接口，是Jakarta Mail的依赖规范；jakarta-activation是其官方实现，同样依赖对应的API JAR提供接口定义。

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