本文详解如何在 Maven 项目中精准引用带有 classifier（如 importable）的自定义构建产物，解决 Spring Boot 项目因 BOOT-INF 导致类路径不可见的问题。
本文详解如何在 maven 项目中精准引用带有 `classifier`（如 `importable`）的自定义构建产物，解决 spring boot 项目因 `boot-inf` 导致类路径不可见的问题。
在基于 Spring Boot 的多模块 Maven 项目中，一个常见场景是：你开发了一个工具类库（utility），它本身是一个 Spring Boot 可执行应用（含 spring-boot-maven-plugin），因此默认打包生成的 utility-1.0.jar 内部结构为 BOOT-INF/classes/...，导致其他项目直接依赖时无法加载其公共类——因为标准 Java 类加载器不识别 BOOT-INF 目录。
为解决此问题，你在 utility 项目的 pom.xml 中配置了 maven-jar-plugin，在 package 阶段额外生成一个不含 BOOT-INF、结构扁平（即标准 Java JAR）的变体，并通过
<build><plugins><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-jar-plugin</artifactid><executions><execution><goals><goal>jar</goal></goals><phase>package</phase><configuration><classifier>importable</classifier></configuration></execution></executions></plugin><plugin><groupid>org.springframework.boot</groupid><artifactid>spring-boot-maven-plugin</artifactid></plugin></plugins></build>
执行 mvn clean package 后，本地仓库（如 ~/.m2/repository/com/acme/utility/1.0/）将包含：
- utility-1.0.jar（Spring Boot 可执行包，含 BOOT-INF）
- utility-1.0-importable.jar（标准类库包，com.acme.* 类直接位于根路径）
✅ 此时，在应用项目的 pom.xml 中，必须显式声明 classifier 才能准确引用该可导入版本：
<dependency><groupid>com.acme</groupid><artifactid>utility</artifactid><version>1.0</version><classifier>importable</classifier><!-- 关键：指定 classifier --></dependency>
⚠️ 注意事项：
- classifier 是 Maven 坐标（groupId:artifactId:version:classifier）的第四维标识符，缺省值为空字符串（即未声明 classifier 时等价于
），因此不加该标签将默认解析为 utility-1.0.jar。 - classifier 不影响依赖传递性，但要求被依赖方（utility）确实在构建过程中生成了对应文件（可通过 mvn dependency:copy-dependencies -DincludeClassifiers=true 验证）。
- 若 utility 项目未部署到远程仓库，请确保已执行 mvn install 将 *-importable.jar 安装至本地仓库；若需发布至 Nexus 私服，mvn deploy 会自动上传所有 classifier 变体。
- IDE（如 IntelliJ IDEA）可能需要手动刷新 Maven 项目（右键 → Reload project）才能识别新增的 classifier 依赖。
? 进阶建议：
对于长期维护的工具库，更推荐将 utility 拆分为两个模块：
- utility-core（纯 Java Library，无 Spring Boot 插件，生成标准 JAR）
- utility-boot-app（仅负责封装启动逻辑，依赖 utility-core）
这样可从根本上规避 classifier 管理复杂度，提升模块职责清晰度与复用可靠性。
