gradle离线构建可行，需先联网完整下载所有依赖（含插件、传递依赖）至本地缓存（~/.gradle/caches/），再通过./gradlew build --offline断网构建；动态版本和私有仓库需提前成功解析，否则离线失败。

Gradle 本身不提供“一键离线构建”功能，但可以通过提前下载并缓存所有依赖，在无网络环境下完成构建。核心在于：让 Gradle 在有网时把项目所需的所有依赖（包括插件、库、传递依赖）完整拉取并存入本地缓存；之后断网也能复用这些缓存。

提前触发完整依赖解析与下载

单纯执行 ./gradlew build 可能不会下载全部依赖（比如某些插件或测试时才需的依赖）。更稳妥的方式是主动触发全量解析：

• 运行 ./gradlew --refresh-dependencies build（强制刷新并下载所有已声明依赖）
• 或更彻底地执行：./gradlew resolveDependencies --configuration compileClasspath runtimeClasspath testCompileClasspath testRuntimeClasspath（显式解析常见配置）
• 确保 settings.gradle 中的插件仓库（如 pluginManagement { repositories { ... } }）也已配置好，并在联网时成功加载过插件

确认依赖已完整缓存到本地

Gradle 默认将依赖存放在用户主目录下的 ~/.gradle/caches/（Linux/macOS）或 %USERPROFILE%\.gradle\caches\（Windows）。验证是否齐全：

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

• 检查 ~/.gradle/caches/modules-2/files-2.1/ 是否存在大量 jar/pom 文件（对应各依赖）
• 检查 ~/.gradle/caches/plugins-xx/ 是否有你项目用到的插件（如 kotlin-dsl、spring-boot等）
• 可临时断网后运行 ./gradlew build --info，观察日志中是否出现 Downloaded from ... —— 若没有且构建成功，说明已离线可用

离线构建时启用 --offline 模式

断网后，必须显式启用离线模式，否则 Gradle 会尝试连接远程仓库并失败：

• 执行 ./gradlew build --offline
• --offline 会跳过所有网络请求，只读取本地缓存；若某依赖缺失，会直接报错（提示 “Could not resolve …”），说明前期缓存不全
• 建议在 CI 或打包脚本中固定加上该参数，避免环境波动影响

处理私有仓库和动态版本等特殊依赖

以下情况容易导致离线失败，需额外注意：

• 私有 Maven/Nexus 仓库：确保其 URL 已配置在 build.gradle 的 repositories 块中，且联网时至少成功命中一次；若仓库不可达，Gradle 不会跳过它而尝试下一个
• 动态版本（如 1.2.+ 或 latest.release）：Gradle 离线时不解析新版本，但首次下载时可能只缓存了某个快照。建议改用固定版本（如 1.2.3）提升确定性
• Gradle Wrapper 版本：确保 gradle/wrapper/gradle-wrapper.jar 已存在（通常自带），且对应版本的 Gradle 发行包已缓存于 ~/.gradle/wrapper/dists/

不复杂但容易忽略 —— 关键不是“怎么离线”，而是“怎么确保所有东西都提前下全”。只要缓存到位，--offline 就是可靠的。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南