GitLab CI配置中使用Java完整路径执行命令失败排查

以下是几个常见原因和对应的解决方法：

• 权限不足
  GitLab Runner默认以gitlab-runner用户运行，该用户可能没有目标文件/目录的访问权限：

  • 先在VM中执行ls -l /opt/java11/jdk-11/bin/java和ls -l /home/gitlab-runner/tools/ciVersioner-1.0.jar，确认文件权限是否允许gitlab-runner用户读取和执行。
  • 若权限不足，执行sudo chmod +x /opt/java11/jdk-11/bin/java赋予执行权限，同时确保父目录（如/opt/java11、/home/gitlab-runner/tools）也有对应的访问权限。

• 未捕获错误输出
  CI中默认可能只显示标准输出，看不到错误信息，导致误以为命令未执行：

  • 修改CI命令为/opt/java11/jdk-11/bin/java -jar /home/gitlab-runner/tools/ciVersioner-1.0.jar $MAJOR $MINOR $CI_COMMIT_SHORT_SHA 2>&1，将错误输出重定向到标准输出，查看具体报错内容。

• 路径拼写或大小写问题
  Linux系统路径大小写敏感，仔细核对命令中的路径拼写，比如jdk-11是否正确、ciVersioner-1.0.jar的大小写是否与实际文件完全一致。

• Runner类型不匹配
  如果使用的是Docker类型的GitLab Runner，容器内的环境与VM主机独立，不存在/opt/java11这类主机路径：

  • 要么切换为Shell类型的Runner，要么在Docker镜像中预先安装Java 11并打包jar包到镜像内。

• 变量未正确传递
  检查$MAJOR、$MINOR变量是否在CI job中正确定义并传递：

  • 在执行Java命令前添加步骤echo $MAJOR $MINOR $CI_COMMIT_SHORT_SHA，确认变量值是否符合预期，空变量可能导致jar包执行异常。

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