Ionic 5/React项目Android生产构建失败，Gradle报目录创建错误
2026-9-25
错误根因
报错的核心原因是Gradle尝试在**系统根目录/**下创建.gradle缓存目录，普通运行身份没有系统根目录的写入权限，导致目录创建失败，直接中断构建流程。
解决方案
1. 修正项目内Gradle配置
进入项目的android/gradle.properties文件，查找gradle.user.home配置项：
- 如果该配置值为
/、空值或者其他无权限路径，修改为当前用户的.gradle目录绝对路径：- Linux/macOS示例：
gradle.user.home=/home/你的用户名/.gradle - Windows示例：
gradle.user.home=C:\\Users\\你的用户名\\.gradle
- Linux/macOS示例：
- 也可以直接删除该配置项，Gradle默认会使用当前用户家目录下的
.gradle路径。
2. 修正Android Studio全局Gradle配置
- 打开Android Studio设置页：
File → Settings → Build, Execution, Deployment → Build Tools → Gradle - 找到
Gradle user home配置项，确认路径指向当前用户有权限读写的目录，不可设置为系统根目录/ - 保存配置后重启Android Studio生效。
3. 清理缓存重新构建
执行以下操作清空旧缓存，再触发构建：
- 删除Ionic项目下的三个目录：
android/.gradle、android/build、android/app/build - 回到项目根目录执行同步命令：
- Capacitor项目执行：
ionic cap sync android - Cordova项目执行：
ionic cordova prepare android
- Capacitor项目执行：
- 重新在Android Studio中执行生产构建即可。
内容的提问来源于stack exchange，提问作者Devstar34
相关产品推荐
相关产品推荐
