Gitlab-runner执行Maven构建报权限拒绝，加-X参数却成功

问题描述 #

使用GitLab Runner结合Maven镜像构建Java项目，此前运行正常，昨日起执行命令mvn clean install -P prd -Dmaven.test.skip=true时出现权限拒绝错误，但添加-X调试参数后构建可成功完成。已尝试更换Maven编译器版本、检查GitLab Runner账号权限、使用sudo执行命令，均未解决问题，需明确调试模式与权限问题的关联原因。

报错信息 #

[INFO] --- maven-compiler-plugin:3.8.1:compile (default-compile) @ gra-api ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 2594 source files to /home/gitlab-runner/builds/CsiK6vc5/0/p202008_0045_gra/graapi/graapi/target/classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.536 s
[INFO] Finished at: 2023-12-06T21:23:20+09:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.8.1:compile (default-compile) on project gra-api: Fatal error compiling: Error creating file with javac arguments: Permission denied -> [Help 1]
[ERROR] 

调试模式与权限问题的关联原因 #

• 临时文件路径差异：默认模式下，maven-compiler-plugin会在系统临时目录（如/tmp）生成javac参数文件，若该目录对GitLab Runner账号无读写权限，就会触发权限拒绝。而调试模式下，插件可能将临时文件生成在项目的target目录（Runner对该目录有明确权限），因此能正常执行。
• 执行速度引发的锁/权限校验冲突：默认构建时Maven执行速度快，创建临时文件的操作可能触发系统瞬时的权限校验或文件锁冲突；调试模式下大量日志输出会减慢执行节奏，避开了这种瞬时冲突。
• 插件行为逻辑调整：maven-compiler-plugin在调试模式下会调整参数文件的创建逻辑，比如使用更宽松的文件权限掩码，或跳过部分严格的权限校验步骤，从而绕过了权限问题。
• 环境变量加载差异：调试模式下Maven会加载更多环境变量，可能包含了正确的临时目录配置（如TMPDIR指向Runner有权限的目录），而默认模式下未加载该变量，导致使用了无权限的系统临时目录。

验证建议 #

• 检查系统临时目录（/tmp）的权限，确认GitLab Runner账号是否具备读写权限，同时排查是否有临时文件清理工具（如tmpwatch）干扰了目录权限。
• 手动指定Maven临时目录：在构建命令中添加参数-Djava.io.tmpdir=/home/gitlab-runner/builds/CsiK6vc5/0/p202008_0045_gra/graapi/graapi/target/tmp（替换为Runner有权限的目录），测试默认模式下是否能成功构建。
• 开启编译器 verbose 日志：在默认构建命令中添加-Dmaven.compiler.verbose=true，对比调试模式下的临时文件路径，确认是否因路径不同导致权限问题。

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