构建Android release APK报错，关闭Android Studio离线模式仍无效的问题排查

核心问题根源 #

• 离线配置残留：Android Studio界面的离线模式开关仅临时控制IDE层面的Gradle启动逻辑，硬编码类离线配置不受界面开关管控：包括项目各级目录gradle.properties文件中写入的org.gradle.offline=true配置、Gradle全局启动参数栏手动添加的--offline指令，这类配置优先级更高，会强制Gradle走离线构建流程，抛出和离线状态下完全一致的依赖无法解析类报错。
• 依赖仓库连通性异常：就算关闭离线模式，当前网络环境无法正常连通Google Maven、Maven Central或项目配置的私有依赖仓库时，Gradle拉取依赖超时返回的报错信息，和离线模式下的报错特征高度重合，会被误判为离线模式未完全关闭。
• 本地依赖缓存损坏：之前离线构建过程中拉取了不完整的依赖缓存片段，切回在线模式后Gradle会优先读取本地已存在的缓存内容，不会自动识别损坏片段重新拉取，最终导致构建流程在依赖解析环节中断。
• 目录读写权限不足：项目根目录、Gradle全局缓存目录（默认存储于用户目录下的.gradle文件夹）存在权限锁，在线拉取依赖时无法写入新的缓存文件，直接触发构建失败。

分步解决操作 #

• 全量排查离线配置残留
  • 逐行检查项目根目录、各业务模块目录下的gradle.properties文件，删除所有包含offline字段的配置行，重点确认不存在org.gradle.offline=true的配置项
  • 打开Android Studio设置页，进入Build, Execution, Deployment > Build Tools > Gradle配置面板，确认Gradle全局启动参数栏不存在--offline指令
• 验证依赖仓库连通性
  • 在系统终端测试官方依赖仓库的网络连通性，若存在DNS解析失败、代理拦截问题，可在gradle.properties中配置和当前网络匹配的代理参数，或切换可正常访问的网络环境重试
  • 检查项目settings.gradle、根目录build.gradle中的仓库配置，确认未将官方仓库地址注释，避免所有依赖请求指向无法连通的私有源
• 修复损坏的Gradle缓存
  • 在Android Studio右侧Gradle工具面板，点击离线模式切换按钮反复切换2次，触发Gradle重新加载全量配置
  • 在项目根目录终端执行./gradlew build --refresh-dependencies命令，强制Gradle跳过本地缓存校验，重新拉取全量依赖
  • 若刷新操作无效，可手动删除.gradle/caches/modules-2路径下的缓存文件，重新触发构建让Gradle重新拉取完整依赖
• 修复目录读写权限
  • 对项目根目录、用户目录下的.gradle文件夹开放当前用户的读写权限，避免构建过程中因权限不足无法写入依赖缓存

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