java 中的运行时依赖指编译阶段无需该类库参与，仅在程序启动或执行过程中通过反射、spi、服务加载或动态代理等方式加载和使用——典型场景包括 jdbc 驱动、日志桥接器（slf4j-jdk14）、spring boot 的自动配置等。
java 中的运行时依赖指编译阶段无需该类库参与，仅在程序启动或执行过程中通过反射、spi、服务加载或动态代理等方式加载和使用——典型场景包括 jdbc 驱动、日志桥接器（slf4j-jdk14）、spring boot 的自动配置等。
在 Java 生态中，“运行时依赖”（runtime-only dependency）并非指“代码完全不感知该依赖”，而是指源码编译时不直接引用其类型（无 import、无 new、无继承/实现），但程序在运行期通过松耦合机制动态加载并使用它。这突破了“有调用就必须编译可见”的表层理解，核心依赖于 JVM 的动态类加载能力和 Java 语言的抽象机制。
✅ 典型实现方式与示例
1. 基于接口 + SPI（Service Provider Interface）
这是最规范、最常用的运行时依赖模式。你面向接口编程，编译时只依赖接口定义（如 java.sql.Driver），而具体实现（如 com.mysql.cj.jdbc.Driver）由 META-INF/services/java.sql.Driver 文件声明，并在运行时由 ServiceLoader 自动发现：
// 编译时仅需 java.sql 包（JDK 自带，无需额外依赖）
Connection conn = DriverManager.getConnection("jdbc:mysql://localhost/test", user, pwd);Maven 中可将 MySQL 驱动声明为 runtime 范围，确保它不参与编译，仅打包进运行环境：
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.33</version> <scope>runtime</scope> <!-- 关键：编译跳过，运行必需 --> </dependency>
2. 基于反射动态加载类
当类名以字符串形式传入，且通过 Class.forName() 或 ClassLoader.loadClass() 加载时，该类在编译期完全不可见：
立即学习“Java免费学习笔记（深入）”；
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
public void loadPlugin(String className) throws Exception {
Class<?> clazz = Class.forName(className); // className 可来自配置文件或用户输入
Plugin plugin = (Plugin) clazz.getDeclaredConstructor().newInstance();
plugin.execute();
}此时 className = "com.example.MyCustomPlugin" 对应的 JAR 只需在运行时置于 classpath，编译时无需任何依赖。
3. 日志桥接与 SLF4J 绑定
SLF4J API（slf4j-api）是编译期依赖；而具体实现如 logback-classic 或 slf4j-jdk14 是运行时绑定的：
<!-- 编译只需 API --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>2.0.9</version> <!-- compile scope 默认 --> </dependency> <!-- 运行时才需要，不参与编译 --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>2.0.9</version> <scope>runtime</scope> </dependency>
你的代码始终写 LoggerFactory.getLogger(...)，具体日志实现由运行时 classpath 决定。
⚠️ 注意事项
-
runtime依赖不会传递：若 A 依赖 B（runtime），B 依赖 C（compile），则 C 不会出现在 A 的编译 classpath 中，也不会自动加入 A 的运行 classpath —— 必须显式声明。 - IDE 可能误报：部分 IDE 在未配置 runtime 依赖时提示“ClassNotFoundException”，需检查运行配置（如 Maven profile、IDE 的 Run Configuration）是否包含对应 JAR。
-
模块系统（JPMS）限制：Java 9+ 模块中，
requires static类似 compile-time optional，但真正 runtime-only 仍需结合ServiceLoader或反射实现，模块声明本身不支持纯 runtime 依赖语法。
✅ 总结
运行时依赖的本质是面向抽象（接口/标准API）开发，延迟绑定具体实现。它提升了系统的可插拔性与解耦度，是框架设计（如 Spring、Hibernate、JDBC）的基石。合理使用 <scope>runtime</scope> 不仅精简编译依赖，更能清晰表达架构意图：哪些是契约，哪些是策略实现。
