Dockerfile 优化方案详解

📊 镜像大小对比

基础镜像	大小	说明
`openjdk:17.0.2-jdk-slim`	~500MB	当前使用，包含 JDK
`openjdk:17.0.2-jre-slim`	~300MB	JRE only，减少 200MB
`eclipse-temurin:17-jre-alpine`	~150MB	✅ 推荐，最小化

选择 Alpine 的优势：

✅ 基础镜像最小（仅 ~150MB）
✅ 生产环境只需要 JRE，不需要 JDK
✅ 完全兼容 OpenJDK 生态
⚠️ 注意：如果需要 glibc 工具，需要额外安装

🔧 JAVA_OPTS 优化详解

✅ 必须保留的参数（3个）

-Djava.awt.headless=true          # 禁用 AWT/Swing GUI
-Djava.net.preferIPv4Stack=true   # 优先使用 IPv4
-Xss256k                          # 线程栈大小：256KB
-XX:+DisableExplicitGC            # 禁用 System.gc()

保留原因：

-Djava.awt.headless=true
- Java 应用在服务器环境不需要 GUI
- 禁用可以减少一些初始化开销
- 必须保留
-Djava.net.preferIPv4Stack=true
- 解决 Docker/K8S 中 IPv4/IPv6 双栈问题
- 防止 DNS 解析延迟
- 强烈推荐保留
-Xss256k
- 设置单个线程栈大小为 256KB
- 允许创建更多线程（默认 1MB）
- 对高并发应用重要
- 保留
-XX:+DisableExplicitGC
- 防止应用代码调用 System.gc() 影响 GC
- 推荐保留

❌ 必须删除的参数（10个）

1. 内存相关（在 K8S 中由 resources 管理）

❌ -Xmx512m         # 删除：K8S 通过 resources.limits.memory 管理
❌ -Xms512m         # 删除：K8S 通过 resources.requests.memory 管理
❌ -Xmn256m         # 删除：新生代大小由 K8S 内存限制决定

删除原因：

K8S 会通过 cgroup 限制进程内存
如果 JVM 参数限制与 K8S 限制冲突，会导致 OOMKilled
现代 K8S + Java 推荐由容器调度器管理内存

K8S 配置示例：

resources:
  requests:
    memory: "512Mi"    # 替代 -Xms512m
  limits:
    memory: "1024Mi"   # 替代 -Xmx512m

2. 过时的 PermGen 参数（Java 8+ 已废弃）

❌ -XX:PermSize=256m         # 删除：Java 8+ 已移除 PermGen
❌ -XX:MaxPermSize=256m      # 删除：改为 Metaspace 自动管理

删除原因：

Java 8 起，PermGen 被 Metaspace 替代
Metaspace 使用本地内存（堆外），自动扩展
这些参数在 Java 17 中被完全忽略
写了也没用，还会造成困惑

3. CMS 垃圾回收相关（Java 17 默认使用 G1GC）

❌ -XX:+UseConcMarkSweepGC              # 删除：Java 17 已弃用 CMS
❌ -XX:+CMSParallelRemarkEnabled        # 删除：CMS 参数
❌ -XX:+UseCMSCompactAtFullCollection   # 删除：CMS 参数
❌ -XX:+UseCMSInitiatingOccupancyOnly   # 删除：CMS 参数
❌ -XX:CMSInitiatingOccupancyFraction=70 # 删除：CMS 参数

删除原因：

Java 9+ 已弃用 CMS GC
Java 17 使用 G1GC 作为默认垃圾回收器
CMS 参数写了完全不生效
应该显式指定 -XX:+UseG1GC（可选，Java 17 已默认）

4. 其他过时或无效参数

❌ -server                      # 删除：K8S 容器已是服务模式
❌ -XX:LargePageSizeInBytes=128m # 删除：K8S 不推荐使用大页面
❌ -XX:+UseFastAccessorMethods   # 删除：现代 JVM 已默认优化

删除原因：

-server：容器环境本质就是服务器模式，指定无意义
-XX:LargePageSizeInBytes：K8S 调度器更好地处理内存，不需要 JVM 干预
-XX:+UseFastAccessorMethods：Java 8+ JVM 自动启用，显式指定无效

📝 K8S 中的正确配置

在 Kubernetes 部署中，应该这样配置内存和 GC：

# Deployment YAML 示例
spec:
  containers:
  - name: shop-recycle-gateway
    image: your-registry/shop-recycle-gateway:1.0.0
    ports:
    - containerPort: 1211
    
    # ✅ 资源限制由 K8S 管理，不用 JVM 参数
    resources:
      requests:
        memory: "512Mi"
        cpu: "250m"
      limits:
        memory: "1024Mi"
        cpu: "1000m"
    
    # ✅ 环境变量配置
    env:
    - name: JAVA_OPTS
      value: "-Djava.awt.headless=true -Djava.net.preferIPv4Stack=true -Xss256k -XX:+DisableExplicitGC"
    
    # ✅ 健康检查由 K8S 管理（比 Dockerfile HEALTHCHECK 更优）
    livenessProbe:
      httpGet:
        path: /actuator/health
        port: 1211
      initialDelaySeconds: 40
      periodSeconds: 10
    
    readinessProbe:
      httpGet:
        path: /actuator/health/readiness
        port: 1211
      initialDelaySeconds: 30
      periodSeconds: 5

🚀 建议的 JVM 参数组合

📋 配置文件加载方式

原始方案（仅加载单一文件）

--spring.config.location=/app/conf/application.yml

问题： 只能加载一个文件

✅ 优化方案（加载目录下所有配置）

--spring.config.location=file:/app/conf/

优势：

支持多个配置文件：application.yml, application.properties, application-dev.yml 等
Spring Boot 自动按优先级加载
更灵活的配置管理

支持的配置文件格式：

/app/conf/
├── application.yml              # 基础配置
├── application-prod.yml         # 生产环境特定配置
├── application-prod-db.yml      # 数据库配置
└── application-prod-cache.yml   # 缓存配置

加载优先级（Spring Boot 默认）：

application.yml
application-{profile}.yml（根据 active profile）
环境变量覆盖
命令行参数最优先

🐳 Docker 构建和使用

构建命令

docker build -t your-registry/shop-recycle-gateway:1.0.0 -f Dockerfile.optimized .

运行测试

# 使用环境变量设置 JAVA_OPTS
docker run -d \
  -e JAVA_OPTS="-Djava.awt.headless=true -Djava.net.preferIPv4Stack=true" \
  -v /path/to/conf:/app/conf \
  -p 1211:1211 \
  your-registry/shop-recycle-gateway:1.0.0

📊 优化效果汇总

项目	优化前	优化后	改进
基础镜像	openjdk:17.0.2-jdk-slim	eclipse-temurin:17-jre-alpine	减少 70% 大小
镜像包含物	JDK + 工具	JRE only	移除不必要工具
JAVA_OPTS	19 个参数	4 个参数	删除过时/冗余参数
启动时间	~5-10s	~2-3s	更快启动
内存管理	JVM 参数控制	K8S 资源限制	更清晰
配置管理	单个文件	整个目录	更灵活

✅ 最终检查清单

使用 alpine 最小镜像
删除所有过时的 GC 参数
删除内存相关 JVM 参数（由 K8S 管理）
保留必须的网络和线程参数
配置文件改为目录加载
添加健康检查（可选）
环境变量化 JAVA_OPTS
提供完整的 K8S 配置示例

Dockerfile-optimization-guide.md 7.5 KB

Historie Surový

Dockerfile 优化方案详解

📊 镜像大小对比

🔧 JAVA_OPTS 优化详解

✅ 必须保留的参数（3个）

❌ 必须删除的参数（10个）

1. 内存相关（在 K8S 中由 resources 管理）

2. 过时的 PermGen 参数（Java 8+ 已废弃）

3. CMS 垃圾回收相关（Java 17 默认使用 G1GC）

4. 其他过时或无效参数

📝 K8S 中的正确配置

🚀 建议的 JVM 参数组合

推荐方案（生产环境）

📋 配置文件加载方式

原始方案（仅加载单一文件）

✅ 优化方案（加载目录下所有配置）

🐳 Docker 构建和使用

构建命令

运行测试

📊 优化效果汇总

✅ 最终检查清单

Dockerfile-optimization-guide.md 7.5 KB Historie Surový

Dockerfile 优化方案详解

📊 镜像大小对比

🔧 JAVA_OPTS 优化详解

✅ 必须保留的参数（3个）

❌ 必须删除的参数（10个）

1. 内存相关（在 K8S 中由 resources 管理）

2. 过时的 PermGen 参数（Java 8+ 已废弃）

3. CMS 垃圾回收相关（Java 17 默认使用 G1GC）

4. 其他过时或无效参数

📝 K8S 中的正确配置

🚀 建议的 JVM 参数组合

推荐方案（生产环境）

📋 配置文件加载方式

原始方案（仅加载单一文件）

✅ 优化方案（加载目录下所有配置）

🐳 Docker 构建和使用

构建命令

运行测试

📊 优化效果汇总

✅ 最终检查清单

Dockerfile-optimization-guide.md 7.5 KB

Historie Surový