内网离线环境下，Maven依赖需用mvn install:install-file手动安装jar及pom；导出全量依赖须覆盖所有scope并注意classifier和架构匹配；settings.xml需配置本地仓库profile并显式激活；JDK须版本、vendor、src.zip全一致。
内网环境无法联网时，Maven 依赖怎么装进本地仓库
离线环境下，mvn install:install-file 是最直接、最可控的方案。它不依赖远程仓库配置，也不需要修改 settings.xml，只要把 jar 包和对应元信息（如 pom.xml）准备好，就能手动塞进本地 ~/.m2/repository。
常见错误是只传 .jar 却漏掉 pom.xml，导致其他模块引用时报 Could not resolve dependencies —— Maven 能看到包，但不知道它的坐标、依赖树和打包类型。
- 必须提供
-Dfile=xxx.jar和-DpomFile=xxx.pom（或用-DgeneratePom=true简单生成基础 pom） - 务必指定完整坐标：
-DgroupId=com.example-DartifactId=utils-Dversion=1.0.0-Dpackaging=jar - 若 jar 来自某家私有 SDK（比如某银行加密组件），注意检查其
MANIFEST.MF是否含Implementation-Version，优先按它设-Dversion - 执行后去
~/.m2/repository/com/example/utils/1.0.0/下确认utils-1.0.0.jar和utils-1.0.0.pom都存在
如何把整个项目依赖树导出为可离线安装的 zip 包
用 mvn dependency:copy-dependencies 只能拉 runtime 依赖，漏掉 provided 和 system 范围的 jar，也搞不定插件依赖（比如 maven-compiler-plugin）。真正可靠的方案是先在有网机器上跑 mvn dependency:resolve，再配合 mvn dependency:tree -DoutputFile=deps.txt 定向分析。
实际操作中，最容易被忽略的是 test 范围依赖——它们不会出现在主 classpath，但如果你的内网要跑单元测试，就得单独导出。
立即学习“Java免费学习笔记（深入）”；
- 导出全部 scope 的依赖：运行
mvn dependency:copy-dependencies -DincludeScope=runtime -DoutputDirectory=./lib后，再补上-DincludeScope=test和-DincludeScope=compile两轮 -
system依赖（如<scope>system</scope>+<systempath>xxx.jar</systempath>）必须人工识别并拷贝，Maven 不会自动解析它的路径 - 导出的 jar 包名可能含 classifier（如
netty-transport-native-epoll-4.1.94.Final-linux-x86_64.jar），这类平台相关包不能跨系统复用，内网服务器架构（x86_64 / aarch64）必须与导出机一致
离线 Maven settings.xml 怎么配才不踩坑
内网里很多人直接删掉 <mirror></mirror> 或注释所有 <repository></repository>，结果发现连 central 的元数据都拉不到，编译卡在 “Downloading from central…”。这不是网络问题，是 Maven 默认仍会尝试连接远程仓库做 metadata 检查。
关键不是“禁用远程”，而是“告诉 Maven：别连，我全本地有”。这靠两个配置联动实现。
- 在
settings.xml的<profiles></profiles>里定义一个 profile，启用<repositories></repositories>和<pluginrepositories></pluginrepositories>，全部指向本地文件路径：<url>file:///opt/m2-repo</url> - 同时设置
<mirrors></mirrors>把所有远程域名（*）强制映射到这个本地 repo：<mirrorof>*</mirrorof>+<url>file:///opt/m2-repo</url> - 必须执行
mvn -Poffline-profile clean compile显式激活 profile，光改 settings 不生效 - 如果本地 repo 是从另一台机器同步来的，注意校验
sha1文件是否完整——缺.sha1会导致 Maven 认为 artifact 损坏而跳过使用
Java 编译器和 JDK 自身怎么离线部署
很多团队只顾搬 Maven 依赖，忘了 javac 和 rt.jar（或 modules-java.base）也是“依赖”。尤其当内网服务器 JDK 版本和开发机不一致时，sourceCompatibility 和 targetCompatibility 设错会导致 UnsupportedClassVersionError，但错误堆栈根本不会提示是 JDK 版本问题。
最稳妥的做法是：内网服务器上部署完整 JDK（非 JRE），且版本号（如 17.0.8）和开发环境完全一致，包括 vendor（Adoptium / Zulu / Oracle）。
- 不要用
export JAVA_HOME=/opt/jdk-17就完事，还要验证java -version和javac -version输出一致，且无警告 - 如果用 Spring Boot，检查
spring-boot-maven-plugin的java-version配置是否匹配，否则打包时会静默降级字节码版本 - JDK 的
lib/src.zip建议一并拷过去——IDE 在内网调试时，没源码会导致断点失效、变量无法展开
离线迁移最麻烦的从来不是工具链本身，而是每个环节的隐式假设：Maven 认为你有网络、IDE 认为你装了源码、JVM 认为你用的是它“认识”的 class 格式。把这些假设一个个打掉，比堆参数重要得多。
