Java在企业级项目中环境搭建的规范流程_技术教程

企业级Java项目需统一JDK版本与供应商（如OpenJDK 17 LTS），隔离Maven本地仓库，显式声明spring-boot-maven-plugin版本，使用分层JDK镜像并动态设置JVM内存参数。

Java版本与JDK供应商选择必须统一

企业级项目最常踩的坑是开发、测试、生产环境 JDK 版本或厂商不一致，导致 java.lang.UnsupportedClassVersionError 或 JIT 行为差异（比如 ZGC 在 OpenJDK 17+ 才稳定，而某些 Oracle JDK 8u291 的 UseG1GC 有已知内存泄漏）。

建议：
• 统一使用 LTS 版本：当前推荐 OpenJDK 17（长期支持至 2029 年），避免用 Java 21（部分中间件尚未完全适配）
• 禁止混用 Oracle JDK / OpenJDK / Amazon Corretto / Azul Zulu —— 即使版本号相同，java -version 输出的构建字符串也需一致
• 所有环境通过 JAVA_HOME 指向同一解压路径（如 /opt/jdk-17.0.1），禁止用系统包管理器（如 apt install openjdk-17-jdk）安装，因其路径不可控且升级策略不可控

Maven本地仓库与镜像配置要隔离项目级别

多人共用一台构建机或 CI Agent 时，~/.m2/repository 共享会导致依赖污染（例如 A 项目用了 spring-boot-starter-web:3.0.0，B 项目误拉取其 SNAPSHOT 版本）。

实操建议：
• 在项目根目录下创建 .mvn/maven.config，内容为：

-Dmaven.repo.local=./.m2/repository
-Dmaven.wagon.http.ssl.insecure=true
-Dmaven.wagon.http.ssl.allowall=true

• 同时在 settings.xml 中强制配置国内镜像（如阿里云）：


  
    aliyun
    central
    https://maven.aliyun.com/repository/public

• 禁止在全局 $M2_HOME/conf/settings.xml 中写入，它会被 maven.config 覆盖，但容易引发团队成员误判

Spring Boot项目必须显式声明`spring-boot-maven-plugin`版本

不指定插件版本时，Maven 会根据 spring-boot-starter-parent 的 BOM 推导，但 CI 环境若缓存了旧版插件（如 3.0.0），而项目实际用的是 spring-boot-starter-parent:3.1.12，会导致 mvn spring-boot:build-image 失败并报错：Plugin 'org.springframework.boot:spring-boot-maven-plugin:3.0.0' not found。

正确做法：
• 在 pom.xml 的中明确写死版本：


  org.springframework.boot
  spring-boot-maven-plugin
  3.1.12

• 同时确保该版本与 spring-boot-starter-parent 主版本严格一致（如 parent 是 3.1.12，插件就不能用 3.2.0）
• 若使用多模块项目，该插件只需在最终打包模块（含 @SpringBootApplication 的模块）中声明，父 POM 不需要

Docker 构建必须用分层 JDK 基础镜像而非 `openjdk:17-jre-slim`

直接使用官方 openjdk:17-jre-slim 会导致两个问题：一是镜像内含完整 JRE（含 jconsole、jstack 等调试工具），体积大且存在安全风险；二是无法复用 Maven 构建阶段的依赖层，每次构建都重拉全部 jar。

推荐方案：
• 使用 eclipse/temurin:17-jre-jammy（轻量、定期更新、无调试工具）
• Dockerfile 必须采用多阶段构建，且 FROM maven:3.9.6-openjdk-17 阶段只用于编译，COPY --from=0 target/*.jar 到运行阶段
• 禁止在运行阶段执行 java -jar app.jar，改用 ENTRYPOINT ["java","-XX:+UseContainerSupport","-Xms512m","-Xmx1g","-jar","/app.jar"]，其中 -XX:+UseContainerSupport 是关键，否则 JVM 无法正确识别容器内存限制