Unity新手求助：Gradle构建失败及SDK只读异常问题

核心原因 #

Unity默认将Android SDK部署在C盘Program Files目录下，该目录受Windows系统权限管控，默认处于只读状态，导致Unity无法修改SDK内的package.xml文件，最终触发Gradle构建失败。

具体解决方案 #

方案1：修改SDK目录权限 #

• 定位SDK路径：C:\Program Files\Unity\Hub\Editor\2022.3.11f1\Editor\Data\PlaybackEngines\AndroidPlayer\SDK
• 右键该文件夹，选择属性，切换到安全选项卡
• 点击编辑，选中当前登录的用户账户，勾选完全控制的允许权限
• 依次点击应用→确定，重启Unity后重新构建

方案2：迁移SDK至非系统目录（推荐长期解决） #

• 打开Unity Hub，进入安装页面，找到2022.3.11f1编辑器，点击右侧三点菜单→添加模块
• 取消勾选已安装的Android Build Support，点击移除等待完成
• 重新勾选Android Build Support，点击下一步，将SDK、JDK、Gradle的安装路径改为非系统盘（如D:\Unity\AndroidSDK）
• 安装完成后，打开项目进入Edit→Preferences→External Tools，确认Android相关路径已更新为新目录
• 重新尝试构建项目

方案3：临时以管理员身份运行Unity #

• 右键Unity Hub图标，选择以管理员身份运行
• 在Hub中打开目标项目，重新执行构建操作
• 注：此为临时方案，每次启动需重复操作，不推荐长期使用

额外排查项 #

• 调整Gradle内存参数：进入Player Settings→Publishing Settings，将Gradle JVM参数-Xmx4096m根据自身内存情况调整（内存不足可改为-Xmx2048m）
• 验证SDK完整性：通过UnityExternal Tools打开Android SDK Manager，检查Android 31、32版本的SDK组件是否完整，缺失则重新安装

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