exec-maven-plugin在Jenkins中无法执行Shell脚本问题求助

这种本地正常但Jenkins跑不起来的情况，大多是环境差异、权限或路径问题导致的，我给你梳理几个排查和解决的方向：

1. 核对Jenkins节点的环境变量与本地差异 #

本地能正常运行的脚本，往往依赖特定的环境配置（比如Java/Maven版本、脚本需要的系统工具路径，像Python、Shell解释器），但Jenkins节点的环境可能完全不同：

• 可以在Jenkins构建流程里先加一个前置步骤，执行echo $PATH或env命令，把输出和本地的环境变量对比，看看有没有缺失的工具路径或关键变量。
• 如果是Shell脚本，要注意Jenkins默认的Shell解释器，比如本地用bash，但Jenkins可能默认用sh或dash，部分语法会有兼容问题。可以在exec插件里明确指定Shell路径，比如：

  <configuration>
    <executable>/bin/bash</executable>
    <arguments>
      <argument>你的脚本文件名.sh</argument>
    </arguments>
  </configuration>
  

2. 确认脚本的执行权限与路径正确性 #

• Jenkins拉取代码后，脚本文件可能丢失了执行权限（本地你可能手动添加过），可以在exec插件执行前，先通过Maven或Jenkins的Shell步骤给脚本加权限，比如执行chmod +x 你的脚本文件名.sh。
• 脚本的路径要尽量用项目根目录的相对路径，避免依赖本地的绝对路径。如果脚本在子目录里，还可以通过workingDirectory指定脚本所在的目录：

  <configuration>
    <workingDirectory>${project.basedir}/scripts</workingDirectory>
    <executable>你的脚本文件名.sh</executable>
  </configuration>
  

3. 查看Jenkins构建的详细日志定位错误 #

很多时候Jenkins执行失败的具体原因会藏在日志里，但默认日志可能不够详细。可以在Jenkins的Maven构建步骤里添加-X参数（开启Debug模式），这样能看到exec插件执行的完整过程，包括执行的命令、环境变量、工作目录等，帮你快速定位问题。

4. 检查Jenkins运行用户的权限 #

Jenkins通常是以专用的jenkins用户运行的，这个用户的权限可能远不如你本地的用户：

• 比如脚本需要读写某个系统目录、访问网络资源，jenkins用户可能没有权限。你可以尝试在Jenkins节点上切换到jenkins用户，手动执行脚本，看看能不能复现问题。

5. 排查脚本本身的兼容性问题 #

• 脚本里如果写了本地的绝对路径（比如/Users/你的名字/工具/xxx），在Jenkins节点上肯定找不到对应的路径，要改成相对路径或通过环境变量来配置路径。
• 还要确认脚本类型和Jenkins节点的操作系统匹配，比如你本地是Windows写的bat脚本，Jenkins节点是Linux系统，那肯定执行不了。

完整的exec插件配置参考 #

<plugin>
  <artifactId>exec-maven-plugin</artifactId>
  <groupId>org.codehaus.mojo</groupId>
  <version>1.6.0</version>
  <executions>
    <execution>
      <id>Version Calculation</id>
      <phase>generate-sources</phase>
      <goals>
        <goal>exec</goal>
      </goals>
      <configuration>
        <!-- 指定脚本所在的目录 -->
        <workingDirectory>${project.basedir}/scripts</workingDirectory>
        <!-- 指定Shell解释器 -->
        <executable>/bin/bash</executable>
        <arguments>
          <argument>version-calc.sh</argument>
          <!-- 如果脚本需要参数，在这里添加 -->
          <argument>${project.version}</argument>
        </arguments>
        <!-- 把脚本执行的输出保存到日志目录，方便排查 -->
        <outputDirectory>${project.build.directory}/logs</outputDirectory>
      </configuration>
    </execution>
  </executions>
</plugin>

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