Maven下载依赖权限异常：丢失父文件夹继承权限致Jenkins无法访问

首先恭喜你第一次提问就把问题描述得这么清晰！这种偶发的权限问题确实头疼，结合你提到的「目标JAR权限和本地Maven仓库源文件完全一致」这个关键线索，给你几个具体的排查方向：

• 溯源本地Maven仓库的权限根源
  既然异常JAR的权限完全继承自本地仓库的源文件，那先从源文件入手：

  • 用icacls "c:\users\xxx\.m2\repository\path\to\problem.jar"命令导出权限明细，检查是否存在异常的拒绝访问控制条目（ACE），或者这些文件所在的仓库子文件夹是否禁用了权限继承；
  • 回忆这些异常JAR第一次下载的场景：是不是用非Jenkins账户（比如管理员）手动执行过Maven命令？Windows下不同账户下载的文件会携带该账户的权限标记，后续复制时可能被保留。

• 调整Maven Dependency插件的复制行为
  Maven的dependency:copy-dependencies插件底层依赖Java的文件复制API，而Java在Windows环境下复制文件时，默认可能保留源文件的权限属性而非继承目标文件夹权限。你可以试试两个调整：

  • 添加参数禁用权限保留：在命令中加入-Dmaven.dependency.copyPermissions=false（部分版本的插件支持该参数，强制复制时不保留源文件权限）；
  • 指定最新版插件执行：旧版本插件可能存在权限处理bug，尝试用mvn org.apache.maven.plugins:maven-dependency-plugin:3.6.1:copy-dependencies -f pom.xml -DoutputDirectory=c:\temp这种方式指定最新版插件运行。

• 排查Windows Server 2016的系统级机制
  Windows的一些特殊设置可能干扰文件权限：

  • 检查UAC虚拟化：如果Jenkins服务账户是普通权限，下载/复制文件时可能触发UAC文件重定向，文件实际存储在C:\Users\JenkinsAccount\AppData\Local\VirtualStore\Temp而非c:\temp，可以去这个路径验证；
  • 确认c:\temp的权限配置：右键文件夹→属性→安全→高级，确保「允许从父项继承权限」已勾选，且Jenkins服务账户有明确的读取/写入权限；
  • 排查安全软件影响：部分杀毒或防护工具会在文件下载后自动修改权限以隔离风险，可暂时禁用安全软件测试是否复现问题。

• 聚焦特定JAR的特殊性
  既然只有特定版本的JAR出问题，建议：

  • 对比正常/异常JAR在Artifactory的元数据：虽然你之前查过权限，但可以确认这些JAR的上传方式——是不是用第三方工具而非标准mvn deploy上传的？有些工具可能会附加特殊文件属性；
  • 手动复制测试：直接从本地仓库复制异常JAR到c:\temp，如果权限依然异常，说明问题出在文件本身属性而非Maven；如果手动复制正常，那就是Maven插件的复制逻辑导致的。

最后，建议开启Maven的debug日志（执行命令时加-X参数），里面会详细记录文件复制的每一步操作，说不定能找到权限变更的触发点。

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