如何配置Maven使其自动执行第三方exec-maven-plugin插件？

问题背景 #

我正在给一个原用Makefile开发的项目添加Maven的pom.xml，项目包含JNI扩展，当前环境是macOS + Java 19。由于Java 10移除了javah工具，org.codehaus.mojo的native-maven-plugin无法生成JNI头文件，所以改用同组织的exec-maven-plugin执行javac -h命令。

我的插件配置如下：

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>exec-maven-plugin</artifactId>
  <version>3.1.0</version>
  <extensions>true</extensions>
  <configuration>
    <executable>javac</executable>
    <commandlineArgs>-h ${project.build.directory}/native/include -d ${project.build.directory}/classes ${basedir}/src/main/java/${fqn_slashes}.java</commandlineArgs>
    <useMavenLogger>true</useMavenLogger>
  </configuration>
  <executions>
    <execution>
      <id>generate-native-header</id>
      <phase>generate-sources</phase>
      <goals>
        <goal>exec</goal>
      </goals>
    </execution>
  </executions>
</plugin>

原本以为添加<extensions>true</extensions>或配置executions后，运行mvn generate-sources会自动执行插件，但实际只有显式运行mvn org.codehaus.mojo:exec-maven-plugin:exec generate-sources才生效。想知道怎么配置才能让Maven自动执行该插件，同时求实用的Maven权威文档站点。

解决方案 #

• 移除<extensions>true</extensions>配置：exec-maven-plugin属于普通执行类插件，不需要开启扩展功能。<extensions>true是给那些需要扩展Maven核心生命周期或打包类型的插件（比如maven-war-plugin）用的，这个配置会干扰插件的正常生命周期绑定。
• 校验${fqn_slashes}变量：确保这个自定义变量在pom.xml的<properties>中正确定义，指向你的JNI类的路径（比如类全限定名是com.example.JNIBridge，则fqn_slashes值为com/example/JNIBridge）。如果变量未定义或路径错误，javac找不到目标文件，插件执行会静默失败，看起来像是没触发。
• 查看调试日志排查：运行mvn generate-sources -X，通过调试日志确认插件的execution是否被Maven识别并触发。如果日志里找不到generate-native-header这个execution的相关记录，说明配置存在语法或结构问题，需要检查xml标签是否闭合、层级是否正确。
• 检查是否有跳过配置：确认pom.xml中没有给exec-maven-plugin添加<skip>true</skip>，也没有全局的插件跳过配置，避免插件被强制跳过执行。

Maven权威文档推荐 #

• Maven官方核心文档：涵盖Maven生命周期、依赖管理、插件配置等核心内容，是最权威的参考资料，内容结构清晰，覆盖从入门到进阶的所有场景。
• Maven插件官方索引：可以查询所有官方及主流第三方插件的详细配置参数、使用示例，比如exec-maven-plugin的官方配置说明就在这里面。
• 《Maven实战》：国内经典的中文Maven书籍，对Maven的核心概念、项目构建流程、特殊场景（如JNI集成）都有详细讲解，适合中文用户学习。

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