启用metadataRepository后native-maven-plugin致自定义运行时构建失败求助

问题根源 #

核心问题是Maven插件执行顺序错误：在package阶段，maven-assembly-plugin先于native-maven-plugin执行，此时GraalVM原生镜像还未构建完成，导致assembly插件找不到需要打包的原生可执行文件，最终zip包生成失败。

最优配置方案 #

1. 调整插件执行顺序 #

将native-maven-plugin移至maven-assembly-plugin之前，确保原生镜像先构建完成，再执行zip打包，同时保留metadataRepository的启用配置。

修正后的pom.xml构建插件配置如下：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
        <!-- 先执行native镜像构建 -->
        <plugin>
            <groupId>org.graalvm.buildtools</groupId>
            <artifactId>native-maven-plugin</artifactId>
            <version>0.9.14</version>
            <extensions>true</extensions>
            <executions>
                <execution>
                    <id>build-native</id>
                    <goals>
                        <goal>compile-no-fork</goal>
                    </goals>
                    <phase>package</phase>
                </execution>
            </executions>
            <configuration>
                <metadataRepository>
                    <enabled>true</enabled>
                </metadataRepository>
            </configuration>
        </plugin>
        <!-- 后执行zip打包 -->
        <plugin>
            <artifactId>maven-assembly-plugin</artifactId>
            <executions>
                <execution>
                    <id>native-zip</id>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                    <inherited>false</inherited>
                </execution>
            </executions>
            <configuration>
                <descriptors>
                    <descriptor>src/assembly/native.xml</descriptor>
                </descriptors>
                <!-- 可选：避免zip文件名自动添加assembly id -->
                <appendAssemblyId>false</appendAssemblyId>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 验证Assembly描述符 #

确保src/assembly/native.xml正确指向原生可执行文件，适配AWS Lambda自定义运行时的示例配置：

<assembly xmlns="http://maven.apache.org/ASSEMBLY/2.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/ASSEMBLY/2.0.0 http://maven.apache.org/xsd/assembly-2.0.0.xsd">
    <id>native</id>
    <formats>
        <format>zip</format>
    </formats>
    <files>
        <!-- 指向native插件生成的可执行文件，默认路径为target/${project.build.finalName} -->
        <file>
            <source>${project.build.directory}/${project.build.finalName}</source>
            <outputDirectory>/</outputDirectory>
            <!-- AWS Lambda自定义运行时要求可执行文件名为bootstrap -->
            <destName>bootstrap</destName>
            <fileMode>0755</fileMode>
        </file>
    </files>
</assembly>

3. 执行构建命令 #

继续使用原命令执行构建：

mvn -ntp clean package -Pnative -e -X

执行完成后，可在target目录下找到生成的zip包，同时原生可执行文件也会保留在该目录。

额外排查点 #

• 查看Maven日志，确认native-maven-plugin的compile-no-fork目标执行成功，生成了原生可执行文件。
• 若metadataRepository启用后出现网络问题，可添加本地元数据仓库配置（需提前下载元数据）：

  <metadataRepository>
      <enabled>true</enabled>
      <localRepositoryPath>${user.home}/.graalvm/metadata</localRepositoryPath>
  </metadataRepository>
  

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