企业级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 中强制配置国内镜像（如阿里云）：<mirrors>
<mirror>
<id>aliyun</id>
<mirrorOf>central</mirrorOf>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>• 禁止在全局
$M2_HOME/conf/settings.xml 中写入 <localrepository></localrepository>，它会被 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 的 <build><plugins></plugins></build> 中明确写死版本：
<plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <version>3.1.12</version> </plugin>
• 同时确保该版本与
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 无法正确识别容器内存限制
-Xmx2g 在 4Gi 内存的 Pod 里会触发 OOMKilled，必须用 -XX:MaxRAMPercentage=75.0 替代。 
