Maven项目配置Pkl生成Java代码遇exec-maven-plugin执行异常求助

你手动通过java -cp执行Pkl代码生成器正常，但使用exec-maven-plugin的java目标时抛出MojoExecutionException，核心差异在于Maven插件的类路径构建逻辑与手动命令行不同，且默认执行环境可能存在路径、权限或依赖缺失问题。以下是具体解决方案：

方案1：改用exec:exec目标（推荐，贴近手动执行逻辑） #

exec:exec直接调用系统的java命令，完全复刻你手动执行的逻辑，避免Maven类路径的干扰：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.5.0</version>
    <executions>
        <execution>
            <phase>generate-sources</phase>
            <goals>
                <goal>exec</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <executable>java</executable>
        <arguments>
            <argument>-cp</argument>
            <!-- 直接引用本地仓库的pkl-tools jar，和手动命令逻辑一致 -->
            <argument>${settings.localRepository}/org/pkl-lang/pkl-tools/0.27.0/pkl-tools-0.27.0.jar</argument>
            <argument>org.pkl.codegen.java.Main</argument>
            <argument>-o</argument>
            <!-- 将输出目录放到target下，避免污染源码目录，且Maven自动管理 -->
            <argument>${project.build.directory}/generated-sources/pkl</argument>
            <!-- 使用Maven变量指定配置文件路径，确保跨环境一致性 -->
            <argument>${project.basedir}/src/main/resources/config/ApplicationConfig.pkl</argument>
        </arguments>
        <!-- 自动创建输出目录，避免路径不存在报错 -->
        <mkdirs>true</mkdirs>
    </configuration>
</plugin>

方案2：修复exec:java的类路径问题 #

如果坚持使用exec:java目标，需确保插件依赖包含Pkl工具的所有传递依赖，并明确类路径范围：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.5.0</version>
    <executions>
        <execution>
            <phase>generate-sources</phase>
            <goals>
                <goal>java</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <mainClass>org.pkl.codegen.java.Main</mainClass>
        <arguments>
            <argument>-o</argument>
            <argument>${project.build.directory}/generated-sources/pkl</argument>
            <argument>${project.basedir}/src/main/resources/config/ApplicationConfig.pkl</argument>
        </arguments>
        <!-- 指定类路径范围为compile，确保依赖全量加载 -->
        <classpathScope>compile</classpathScope>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.pkl-lang</groupId>
            <artifactId>pkl-tools</artifactId>
            <version>0.27.0</version>
            <scope>compile</scope>
        </dependency>
    </dependencies>
</plugin>

关键补充：让Maven识别生成的代码 #

无论用哪种方案，都需要把生成的代码目录加入Maven的编译源路径，否则后续编译会找不到生成的类：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>build-helper-maven-plugin</artifactId>
    <version>3.4.0</version>
    <executions>
        <execution>
            <id>add-pkl-generated-sources</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>add-source</goal>
            </goals>
            <configuration>
                <sources>
                    <source>${project.build.directory}/generated-sources/pkl</source>
                </sources>
            </configuration>
        </execution>
    </executions>
</plugin>

验证步骤 #

1. 执行mvn clean generate-sources，检查target/generated-sources/pkl目录下是否生成了Java类。
2. 执行mvn compile，确认编译正常通过。
3. 运行测试mvn test，验证异常是否消失。

内容的提问来源于stack exchange，提问作者Otávio Vasques