Maven settings.xml offline模式 离线构建Java项目

offline=true仅跳过远程仓库检查，不解决本地缺包、依赖冲突或插件未预装问题；必须先联网完整构建确保本地仓库齐全，且该配置仅在settings根节点生效。

settings.xml 里 offline 设为 true 不等于“本地构建就一定成功”

离线模式只是让 Maven 跳过远程仓库检查，不拉取任何新依赖；但它不会帮你解决本地仓库缺包、依赖冲突或插件未预装的问题。很多同学开 offline=true 后执行 mvn clean compile 直接失败，根本原因是：本地 ~/.m2/repository 根本没存够项目所需的所有依赖和插件。

• 必须先在有网环境完整构建一次（mvn clean compile -U），确保所有传递依赖都落盘
• offline=true 对 mvn dependency:copy-dependencies 这类目标无效——它仍会尝试解析远程坐标，直接报错
• 某些插件（如 maven-compiler-plugin）版本若未在本地仓库存在，离线时连编译器都加载失败

离线构建前必须手动校验本地仓库完整性

光靠 offline=true 没用，得确认 ~/.m2/repository 里真有全部需要的东西。最可靠的方式是比对 pom.xml 中声明的依赖和本地路径是否存在对应文件夹。

• 检查关键依赖是否存在：ls ~/.m2/repository/junit/junit/4.13.2/ —— 如果目录为空或只有 _remote.repositories，说明没下下来
• 插件同样要查：ls ~/.m2/repository/org/apache/maven/plugins/maven-surefire-plugin/3.0.0-M9/
• 用 mvn dependency:resolve -Dclassifier=tests 在联网时跑一次，能提前暴露缺失的测试依赖

settings.xml 的 offline 配置位置和作用范围

offline 是全局开关，只在 <settings></settings> 根节点下生效，不能写在 <profiles></profiles> 或 <servers></servers> 里。设成 true 后，Maven 会跳过所有远程仓库访问，包括中央仓库、私库、甚至 pluginRepositories。

猫宁Morning公益商城系统

猫宁Morning公益商城是中国公益性在线电子商城，以商城B2C模式运营的公益在线商城，是一家致力于将传统公益商城互联网化的创新公益商城。该网上商城系统分为电子商城系统、公益商城系统、后台管理系统，使用Maven对项目进行模块化管理，搭建多模块企业级项目。Morning是在Spring Framework基础上搭建的一个Java基础开发平台，以Spring MVC为模型视图控制器，MyBatis为

下载

• 正确写法：

  <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0">
    <offline>true</offline>
  </settings>

• 错误写法：<profile><offline>true</offline></profile> —— 完全不生效
• 命令行覆盖优先级更高：mvn compile -o（-o 即 offline）会覆盖 settings.xml 里的设置

离线时 mvn install 和 mvn deploy 的行为差异

mvn install 在离线模式下照常运行，把构建产物装进本地仓库；但 mvn deploy 会直接失败，因为它的设计目标就是上传到远程仓库，跟 offline=true 冲突。

立即学习“Java免费学习笔记（深入）”；

• mvn install：只操作 ~/.m2/repository，离线完全 OK
• mvn deploy：报错 org.eclipse.aether.transfer.ArtifactTransferException: Could not transfer artifact ...，哪怕你配了 file:// 协议的本地 deploy 仓库也不行（除非改用 maven-deploy-plugin 的 deploy-file 目标）
• CI 场景注意：Jenkins 流水线里如果用了 mvn deploy，离线构建必然中断，得提前剥离或条件跳过