Unity 2021.3.16f1打包Android遇Gradle报错，疑与PATH环境变量有关

旧Unity版本的PATH路径是否需要移除？ #

• 建议移除这些冗余路径。虽然Unity打包默认优先使用当前项目绑定版本的工具链，但PATH里混着多个Unity版本路径，可能导致系统调用Gradle、Android SDK相关工具时出现优先级混乱，给后续排查问题添乱。
• 操作方法：打开系统环境变量编辑界面，找到PATH变量，删掉2019.4.13f1、2021.3.9f1对应的Unity安装目录路径（一般是XXX\Unity\2019.4.13f1\Editor这类），保存后重启Unity再试。

旧PATH路径是本次构建失败的直接原因吗？ #

• 大概率不是。本次报错的核心是找不到androidx.startup:startup-runtime:1.1.1依赖包，常见触发原因有这些：
  • 项目Gradle配置里的依赖仓库没配全，比如漏掉了google()或mavenCentral()，导致没法从远程仓库拉取依赖；
  • 本地Gradle缓存损坏，或者该依赖的缓存文件丢失；
  • Unity内置的Android SDK/NDK/Gradle版本和项目依赖不兼容；
  • 网络问题导致无法访问远程maven仓库（比如被墙）。

针对本次依赖缺失的修复步骤 #

• 检查Unity Gradle模板配置：
  1. 打开Edit > Project Settings > Player > Android > Publishing Settings，勾选Custom Gradle Template；
  2. 打开生成的mainTemplate.gradle，确认repositories块包含必要仓库：

     repositories {
         google()
         mavenCentral()
         // 其他自定义仓库
     }
     

• 清理本地缓存：
  • 删除项目根目录的Library文件夹，再删掉用户目录下的.gradle缓存（Windows：C:\Users\你的用户名\.gradle；Mac：~/Users/你的用户名/.gradle）；
• 重新同步依赖：
  • 在Unity的Build Settings窗口点击Refresh，触发依赖重新拉取；
• 配置镜像仓库（如果网络访问有问题）：
  • 在mainTemplate.gradle的repositories里添加国内镜像，比如阿里云：

    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        mavenCentral()
    }
    

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