如何调整Maven与Docker构建流程实现插件独立类加载？

一、Maven构建调整 #

1. 排除插件依赖出Spring Boot Uber Jar #

在server模块的pom.xml中，配置Spring Boot Maven插件，将所有插件依赖排除出最终打包的uber jar：

<build>
  <plugins>
    <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <configuration>
        <excludes>
          <!-- 按groupId/artifactId精准排除插件依赖，可批量添加 -->
          <exclude>
            <groupId>com.yourcompany.plugins</groupId>
            <artifactId>plugin-a</artifactId>
          </exclude>
          <exclude>
            <groupId>com.yourcompany.plugins</groupId>
            <artifactId>plugin-b</artifactId>
          </exclude>
        </excludes>
      </configuration>
    </plugin>
  </plugins>
</build>

2. 复制插件及其依赖到独立目录 #

使用Maven Dependency插件的copy-dependencies目标，将每个插件的jar及其传递依赖复制到单独文件夹，支持两种方式：

方式1：单个插件精准控制

适合需要为每个插件单独配置的场景：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-dependency-plugin</artifactId>
  <executions>
    <!-- 复制插件A及其依赖到plugins/plugin-a目录 -->
    <execution>
      <id>copy-plugin-a</id>
      <phase>package</phase>
      <goals>
        <goal>copy-dependencies</goal>
      </goals>
      <configuration>
        <includeGroupIds>com.yourcompany.plugins</includeGroupIds>
        <includeArtifactIds>plugin-a</includeArtifactIds>
        <includeScope>compile</includeScope>
        <outputDirectory>${project.build.directory}/plugins/plugin-a</outputDirectory>
        <excludeTypes>pom</excludeTypes>
      </configuration>
    </execution>
    <!-- 插件B同理添加执行配置 -->
  </executions>
</plugin>

方式2：批量复制所有插件

如果所有插件共享统一groupId（如com.yourcompany.plugins），可批量复制并按Maven仓库结构存放：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-dependency-plugin</artifactId>
  <executions>
    <execution>
      <id>copy-all-plugins</id>
      <phase>package</phase>
      <goals>
        <goal>copy-dependencies</goal>
      </goals>
      <configuration>
        <includeGroupIds>com.yourcompany.plugins</includeGroupIds>
        <includeScope>compile</includeScope>
        <outputDirectory>${project.build.directory}/plugins</outputDirectory>
        <useRepositoryLayout>true</useRepositoryLayout>
        <excludeTypes>pom</excludeTypes>
      </configuration>
    </execution>
  </executions>
</plugin>

执行mvn package后，target/plugins目录下会生成每个插件的独立文件夹，包含插件jar及其所有依赖。

二、Docker构建流程调整 #

多阶段构建Dockerfile #

使用多阶段构建减少镜像体积，先在Maven环境中构建产物，再复制到轻量运行镜像：

# 构建阶段：编译打包项目
FROM maven:3.8.6-openjdk-17 AS builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn package -DskipTests

# 运行阶段：部署应用与插件
FROM openjdk:17-jdk-slim
WORKDIR /app
# 复制Spring Boot主程序jar
COPY --from=builder /app/target/server-*.jar app.jar
# 复制插件目录到镜像
COPY --from=builder /app/target/plugins ./plugins
# 启动命令（可传递插件目录作为参数供应用读取）
CMD ["java", "-jar", "app.jar", "--plugin.base.dir=/app/plugins"]

三、运行时独立类加载实现 #

在Spring Boot应用中实现自定义类加载逻辑，读取每个插件文件夹下的jar：

@Configuration
public class PluginLoader {
    @Value("${plugin.base.dir:/app/plugins}")
    private String pluginBaseDir;

    @PostConstruct
    public void loadPlugins() throws IOException {
        File baseDir = new File(pluginBaseDir);
        if (!baseDir.exists()) return;

        File[] pluginFolders = baseDir.listFiles(File::isDirectory);
        if (pluginFolders == null) return;

        for (File folder : pluginFolders) {
            // 扫描当前插件文件夹下的所有jar
            File[] jars = folder.listFiles(f -> f.getName().endsWith(".jar"));
            if (jars == null) continue;

            // 转换为URL数组供类加载器使用
            URL[] jarUrls = Arrays.stream(jars)
                .map(file -> {
                    try {
                        return file.toURI().toURL();
                    } catch (MalformedURLException e) {
                        throw new RuntimeException("Failed to convert jar to URL", e);
                    }
                })
                .toArray(URL[]::new);

            // 创建独立类加载器（父类加载器使用应用类加载器的父类，避免依赖冲突）
            URLClassLoader pluginClassLoader = new URLClassLoader(jarUrls, ClassLoader.getSystemClassLoader().getParent());
            
            // 通过SPI加载插件实现类（需插件在META-INF/services下声明接口实现）
            ServiceLoader<YourPluginInterface> loader = ServiceLoader.load(YourPluginInterface.class, pluginClassLoader);
            loader.forEach(plugin -> {
                // 将插件实例注册到应用的插件管理容器中
                PluginRegistry.register(plugin);
            });
        }
    }
}

四、关键注意事项 #

• 插件与主应用的公共依赖需抽离到独立API模块，避免类加载冲突
• 测试时需验证不同插件依赖同一类库的不同版本是否能正常隔离运行
• 若插件需要访问主应用的类，需确保这些类在API模块中定义，且主应用与插件均依赖该API模块

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