Maven离线构建成功的核心是本地仓库必须提前准备完整且干净，-o仅跳过远程检查，不解决缺包、插件缺失或元数据干扰问题；需联网执行mvn dependency:go-offline和生命周期命令预缓存全量依赖与插件，并清理*.lastUpdated等文件后，再用mvn -o -nsu -Dmaven.repo.local=...构建。
Java 中 Maven 在离线断网环境下用 -o 参数构建，核心不是“加了 -o 就能跑通”，而是本地仓库必须提前准备完整且干净。-o 只是告诉 Maven 别联网，它不会帮你补缺依赖，也不会跳过插件缺失的错误。
本地仓库要提前导出全量依赖
单纯执行一次 mvn clean compile 并不能保证所有依赖都被缓存。Maven 默认只下载 pom 中显式声明的依赖，而很多构建插件（如 maven-clean-plugin、maven-resources-plugin、maven-compiler-plugin）来自 super POM，不会被常规命令拉取。
- 在联网机器上，先清空旧缓存，新建一个干净的本地仓库目录（比如
/tmp/offline-repo），并在settings.xml中配置<localRepository>/tmp/offline-repo</localRepository> - 运行
mvn dependency:go-offline -Dmaven.repo.local=/tmp/offline-repo，拉取项目依赖 - 再执行
mvn clean package -Dmaven.repo.local=/tmp/offline-repo，触发插件下载（clean、resources、compiler 等都会被缓存） - 为保险起见，额外运行
mvn help:help compiler:help resources:help jar:help，强制缓存常见生命周期插件
离线前必须清理干扰文件
Maven 在离线模式下仍会读取 *.lastUpdated、*.sha1、*.repositories 等元数据文件，一旦发现时间戳过期或校验缺失，就会尝试联网刷新——导致构建失败，哪怕你加了 -o。
- 把整个本地仓库目录（如
/tmp/offline-repo）打包传到离线机 - 解压后，在该目录下执行清理命令：
find . -name "*.lastUpdated" -delete && find . -name "*.sha1" -delete && find . -name "*.repositories" -delete - 也可以更激进：只保留
.jar、.pom、.xml文件，删掉其余所有（如.asc、.md5、.cache等）
离线构建时的正确命令组合
仅用 mvn -o clean package 很容易失败。推荐带上明确参数，避免隐式行为干扰：
立即学习“Java免费学习笔记（深入）”；
-
mvn -o -nsu clean package：-o 表示离线；-nsu（--no-snapshot-updates）禁用快照更新检查，防止因 timestamp 快照触发联网 - 显式指定本地仓库路径：
mvn -o -nsu -Dmaven.repo.local=/path/to/offline-repo clean package，避免误用默认.m2/repository - 跳过测试可加
-DskipTests或-Dmaven.test.skip=true，减少对 test-scoped 依赖的依赖 - 如果项目用了自定义插件或第三方插件，确保它们的 jar 和 pom 都已存在于本地仓库对应路径中
IDE 和 CI 工具中的适配要点
IntelliJ IDEA 或 Jenkins 等工具不认全局 -o，需单独配置：
- IDEA：Settings → Build Tools → Maven → Runner → 勾选 “Work offline”，并指定 “User settings file” 为含
<offline>true</offline>的 settings.xml - Jenkins：在 Pipeline 或 Shell 步骤中，用
mvn -o -Dmaven.repo.local=/your/offline/repo ...，不要依赖全局 Maven 配置 - 注意：IDEA 的 “Reimport project” 按钮在离线模式下可能卡住或报红，此时应忽略提示，直接运行
mvn -o compile验证是否真能编译通过
