Gradle报错：无法移动临时工作区至不可变位置的技术问询

1. 错误常见程度 #

属于Gradle 8.7版本升级后小众但集中出现的问题，主要发生在React Native、Android原生等依赖Gradle构建的项目里。社区反馈占比不高，但升级到8.7的用户碰到的概率远高于旧版本。

2. 最常见根因 #

• 权限冲突：错误栈里的java.nio.file.AccessDeniedException是核心原因。Gradle 8.7对临时工作区的权限管控更严格，当系统进程（比如杀毒软件、文件管理器、IDE后台构建进程）占用了临时目录或目标目录的文件时，Gradle拿不到足够权限完成移动操作。
• 缓存机制变更：8.7版本优化了缓存的临时工作区管理逻辑，之前删node_modules和.gradle的清理方式已经不适配新的缓存结构，残留的锁文件或权限异常没法被彻底清除。
• 文件系统权限异常：Windows用户用NTFS文件系统时，可能存在权限继承配置问题；Linux/macOS用户则可能是项目目录的用户组权限不匹配，导致Gradle进程没法读写目标目录。

3. 修复方案及长期规避措施 #

即时修复方案 #

• 强制释放文件占用：
  • Windows：打开任务管理器，结束所有java.exe、gradle.exe相关进程，以及可能占用项目目录的杀毒软件、Android Studio后台构建守护进程。
  • Linux/macOS：执行lsof | grep [你的项目路径]找到占用进程，用kill -9 [进程ID]强制终止。
• 彻底清理缓存：
  除了删除node_modules和.gradle，还要清除：
  • 项目根目录的build文件夹
  • 用户全局Gradle缓存：Linux/macOS路径为~/.gradle/caches，Windows为C:\Users\[你的用户名]\.gradle\caches
  • React Native专属缓存：执行npx react-native start --reset-cache
• 手动修复目录权限：
  • Linux/macOS：执行sudo chown -R [你的用户名]:[用户组] [项目根目录]，确保项目目录所有权归当前用户。
  • Windows：右键项目目录→属性→安全→编辑，给当前用户添加「完全控制」权限。

长期规避措施 #

• 禁用Gradle构建守护：在项目根目录的gradle.properties中添加org.gradle.daemon=false，避免守护进程长期占用文件引发权限冲突。
• 添加杀毒软件白名单：把项目目录、Gradle全局缓存目录加入杀毒软件白名单，防止后台扫描占用文件。
• 临时锁定Gradle版本：如果不需要8.7的特性，可在android/gradle/wrapper/gradle-wrapper.properties里把distributionUrl改回https://services.gradle.org/distributions/gradle-8.6-all.zip，等官方修复后再升级。
• 定期清理全局缓存：每月手动清理一次全局Gradle缓存，避免缓存堆积导致权限异常。

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