在启动 Java 可执行 JAR 文件时，合理配置 JVM 内存参数是保障应用稳定性和性能的关键。本文将系统讲解如何通过命令行参数、环境变量等方式指定内存配置，并结合实际场景提供优化建议。

一、核心内存参数详解

1.1 堆内存配置

示例：

java -Xms1g -Xmx1g -jar app.jar

1.2 元空间配置（Metaspace）

特性：

• JDK 8+ 取代永久代（PermGen）
• 默认无上限，需根据类加载量调整

1.3 线程栈配置

注意：

• 每个线程独立占用，总线程数 = -Xmx / -Xss
• 过小会导致 StackOverflowError

1.4 直接内存配置

二、参数设置方法

2.1 命令行直接指定（推荐）

java -Xms512m -Xmx1g \
     -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m \
     -Xss256k \
     -jar myapp.jar

2.2 通过环境变量配置

# Linux/macOS
export JAVA_OPTS="-Xms1g -Xmx1g -XX:MetaspaceSize=256m"
java $JAVA_OPTS -jar myapp.jar

# Windows
set JAVA_OPTS=-Xms1g -Xmx1g -XX:MetaspaceSize=256m
java %JAVA_OPTS% -jar myapp.jar

2.3 启动脚本集成（以 Bash 为例）

#!/bin/bash
# start.sh
JAVA_OPTS=(
  "-Xms512m"
  "-Xmx1g"
  "-XX:+UseG1GC"
  "-Xloggc:/var/log/app_gc.log"
)

java "${JAVA_OPTS[@]}" -jar /app/myapp.jar

三、高级配置技巧

3.1 垃圾回收日志

java -Xms1g -Xmx1g \
     -Xloggc:/var/log/gc.log \
     -XX:+PrintGCDetails -XX:+PrintGCDateStamps \
     -jar app.jar

3.2 内存参数顺序规则

1. 系统属性 -D 放在 -jar 之前
2. JVM 参数按作用域顺序排列：堆 → 元空间 → 线程栈 → 其他
3. 示例：
4. java -Dapp.env=prod -Xms1g -Xmx1g -jar app.jar

四、性能优化建议

4.1 内存分配原则

4.2 常见问题解决方案

4.2.1 OutOfMemoryError: Java heap space

• 原因：-Xmx 设置过小或存在内存泄漏
• 解决： 增大 -Xmx 值 使用 -XX:+HeapDumpOnOutOfMemoryError 生成堆转储 通过 jmap 分析内存占用

4.2.2 Metaspace 溢出

• 现象：java.lang.OutOfMemoryError: Metaspace
• 解决：
• -XX:MaxMetaspaceSize=1g -XX:MetaspaceSize=512m

五、完整配置示例

java -server \
     -Xms4g -Xmx4g \
     -XX:MetaspaceSize=512m -XX:MaxMetaspaceSize=1g \
     -Xss1m \
     -XX:+UseG1GC -XX:MaxGCPauseMillis=200 \
     -Xloggc:/opt/app/logs/gc.log \
     -XX:+PrintGCDetails -XX:+PrintGCDateStamps \
     -Dspring.profiles.active=prod \
     -jar /opt/app/myapp.jar

六、验证内存配置

# 查看实际分配内存
jps -lvm | grep myapp.jar

# 监控内存使用
jstat -gcutil <pid> 1000

通过合理配置 JVM 内存参数，可显著提升应用性能并避免内存相关故障。建议结合应用负载特性，通过压力测试持续优化内存分配策略。