maven 项目中的依赖并非无条件加入运行时类路径，其实际行为取决于打包类型、作用域（scope）及所用插件——编译期默认包含 compile 和 provided 依赖，而运行时是否包含则由构建目标（如 jar/war/spring boot 可执行包）决定。
maven 项目中的依赖并非无条件加入运行时类路径，其实际行为取决于打包类型、作用域（scope）及所用插件——编译期默认包含 compile 和 provided 依赖，而运行时是否包含则由构建目标（如 jar/war/spring boot 可执行包）决定。
在 Maven 构建生命周期中，“加入类路径”这一行为需严格区分编译期类路径（-classpath for javac）与运行时类路径（-cp for java）。二者受
依赖作用域决定编译与运行时可见性
Maven 定义了多种依赖作用域，其中关键的有：
- compile（默认）：参与编译、测试与运行，通常会出现在最终运行时类路径中（但受打包方式制约）；
- provided：仅在编译和测试阶段有效，预期由运行环境（如 Servlet 容器、JDK 或框架）提供，Maven 不将其打入最终产物（如 WAR 的 WEB-INF/lib），也不会加入可执行 JAR 的 Class-Path 清单；
- runtime：不参与编译，但需在运行时可用（如 JDBC 驱动）；
- test：仅用于测试编译与执行，不会进入主应用的任何类路径；
- system：已弃用，行为不可靠，应避免使用。
例如，以下 pom.xml 片段展示了典型作用域差异：
<dependencies>
<!-- 编译、运行均需要 → 通常打入最终包 -->
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.12.0</version>
</dependency>
<!-- 编译需要，运行由容器提供 → 不打入 WAR -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
<!-- 运行时才加载（如 PostgreSQL 驱动）→ 打入 WAR/JAR，但不参与编译 -->
<dependency>
<groupId>org.postgresql</groupId>
<artifactId>postgresql</artifactId>
<version>42.6.0</version>
<scope>runtime</scope>
</dependency>
</dependencies>打包方式决定最终类路径构成
Maven 本身不直接控制运行时类路径，而是通过插件（如 maven-jar-plugin、maven-war-plugin、spring-boot-maven-plugin）将依赖按规则组装：
立即学习“Java免费学习笔记（深入）”；
| 打包类型 | 插件示例 | 运行时类路径行为说明 |
|---|---|---|
| 普通 JAR（mvn package） | maven-jar-plugin | 仅包含本模块字节码；依赖需手动指定 -cp，或通过 Class-Path 清单引用（需额外配置） |
| WAR（Web 应用） | maven-war-plugin | compile + runtime 依赖自动放入 WEB-INF/lib/；provided 依赖被排除 |
| Spring Boot 可执行 JAR | spring-boot-maven-plugin | 所有 compile 和 runtime 依赖嵌入 BOOT-INF/lib/，provided 仍被忽略 |
| Quarkus 原生镜像 | quarkus-maven-plugin | 依赖经静态分析后仅保留实际调用的类，provided 不参与构建，runtime 需显式启用 |
⚠️ 注意：若未使用标准插件（如自定义 Assembly 或手动构建脚本），类路径行为完全不可预测——此时“所有依赖是否加入类路径”将退化为构建脚本逻辑问题，而非 Maven 规范行为。
验证与调试建议
- 查看生成的 MANIFEST.MF（位于 target/*.jar/META-INF/MANIFEST.MF），检查 Class-Path: 属性；
- 对于 WAR，解压并确认 WEB-INF/lib/ 内容；
- 使用 mvn dependency:tree -Dscope=runtime 分析运行时有效依赖；
- 在 IDE 中运行时，注意其类路径可能与 mvn spring-boot:run 不一致（IDE 通常忽略 provided，但真实部署环境会严格遵循）。
✅ 总结：Maven 的依赖管理是声明式 + 插件驱动的。不要假设“写在 pom 里就一定在运行时可用”。务必依据目标部署形态（WAR/Spring Boot/JVM 服务等）选择恰当作用域，并通过构建产物反向验证类路径组成——这是保障应用可移植性与环境一致性的关键实践。
