本文详解如何在 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）的变体，并通过 <classifier>importable</classifier> 标识它：

<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 时等价于 <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 管理复杂度，提升模块职责清晰度与复用可靠性。