Gradle/Java应用：JVM内存扩容、上限及运行监控方法咨询

我之前在部署Wherehows的时候也碰到过类似的JVM内存问题，咱们一步步来解决你的三个疑问：

因为你用了gradlw build和activator run两个命令，得分别给它们配置JVM参数：

1. 给Gradle构建（gradlw build）设置内存 #

Gradle Wrapper支持两种常用方式指定JVM参数：

• 临时生效（命令行传参）：直接在命令中附加参数，比如给初始堆分配2G，最大堆分配4G：

  ./gradlew build -Dorg.gradle.jvmargs="-Xms2g -Xmx4g"
  

  解释下：-Xms是JVM初始堆内存，-Xmx是最大堆内存，单位可以用g（GB）、m（MB），根据服务器实际内存调整。
• 永久生效（修改配置文件）：在项目根目录的gradle.properties文件里添加一行，这样每次运行gradlew都会自动加载这个配置：

  org.gradle.jvmargs=-Xms2g -Xmx4g
  

2. 给Activator运行（activator run）设置内存 #

Activator是Play框架的工具，它会继承系统的JAVA_OPTS环境变量，也可以直接在命令行指定：

• 临时生效（命令行传参）：

  JAVA_OPTS="-Xms2g -Xmx4g" activator run
  

• 永久生效（修改配置文件）：编辑用户目录下的~/.activator/activatorconfig.txt，添加JVM参数：

  JAVA_OPTS="-Xms2g -Xmx4g"
  

• 32位JVM：受限于地址空间限制，最大堆内存一般在3.5G-4G左右，超过这个值会直接启动失败。
• 64位JVM：理论上没有硬性上限，但实际受限于服务器的物理内存和操作系统的虚拟内存。比如你的服务器有16G物理内存，给JVM分配8G-12G比较合理——要留2-4G给操作系统、数据库、日志服务等其他进程。
• 重要提醒：不是堆内存越大越好！过大的堆会导致GC停顿时间变长，反而拖慢应用性能。建议先从保守值开始调整（比如初始堆设为最大堆的一半），再根据GC日志和监控结果逐步优化。

1. 命令执行后在终端打印内存信息 #

可以用JDK自带的jstat和jps工具配合实现：

• 先获取Java进程的PID：用jps命令列出所有Java进程，找到对应的进程名（比如Gradle构建是GradleDaemon，Activator运行是play.core.server.NettyServer）：

  jps
  

• 然后用jstat打印GC和内存使用详情：

  jstat -gc <PID>
  

  输出里的OU是老年代已使用内存，OC是老年代总大小，MU是元空间已使用内存，MC是元空间总大小，能直观看到内存占用情况。

  如果你想自动化这个过程，可以写个简单的Shell脚本：

  # 执行Gradle构建
  ./gradlew build
  # 获取Gradle守护进程的PID
  PID=$(jps | grep GradleDaemon | awk '{print $1}')
  # 打印内存使用情况
  echo "=== Gradle Build JVM Memory Usage ==="
  jstat -gc $PID
  

2. 在应用代码中实时打印内存信息 #

如果想在代码执行的关键步骤（比如数据导入、处理前后）打印内存，可以调用Java的Runtime类（Jython也能直接调用）：

Java代码示例： #

import java.lang.Runtime;

public class MemoryMonitor {
    public static void printMemoryUsage() {
        Runtime runtime = Runtime.getRuntime();
        long usedMemory = runtime.totalMemory() - runtime.freeMemory();
        long maxMemory = runtime.maxMemory();
        System.out.printf("当前已使用内存: %.2f MB | 最大可用内存: %.2f MB%n",
                usedMemory / (1024.0 * 1024), maxMemory / (1024.0 * 1024));
    }
}

在需要监控的步骤调用MemoryMonitor.printMemoryUsage()即可。

Jython代码示例： #

from java.lang import Runtime

def print_memory_usage():
    runtime = Runtime.getRuntime()
    used_memory = runtime.totalMemory() - runtime.freeMemory()
    max_memory = runtime.maxMemory()
    print("当前已使用内存: %.2f MB | 最大可用内存: %.2f MB" % 
          (used_memory/(1024*1024), max_memory/(1024*1024)))

同样在关键步骤调用这个函数就行。

3. 图形化实时监控 #

用JDK自带的jconsole或jvisualvm工具，打开后选择对应的Java进程，就能实时看到堆内存、非堆内存的变化曲线，以及GC次数、停顿时间等详细信息，非常适合排查内存泄漏或调优。

内容的提问来源于stack exchange，提问作者Joe