记一次 JVM 参数 -version 导致 main 方法未执行的排查

摘要

在 Java 开发中，我们常使用 -XX:+PrintCommandLineFlags 查看 JVM 实际生效的启动参数。然而，若错误地搭配 -version 参数，会导致程序 main 方法无法执行，造成“参数生效但代码未运行”的错觉。本文通过一个真实调试案例，揭示 -version 与 -showversion 的本质区别，并提供兼顾参数透明性、版本信息与程序执行的完整解决方案。

背景

在日常Java开发中，我们经常需要查看JVM参数信息，我在使用PrintCommandLineFlags参数时就遇到了一个问题，示例代码如下：

public class ObjectTest {
    public static void main(String[] args) {
        System.out.println("=== Main 方法开始执行 ===");
        //...
        System.out.println("=== Main 方法执行结束 ===");
    }
}

在使用JVM参数做程序内存信息分析时，直接在IDEA的VMOptions中使用了该参数：

-XX:+PrintCommandLineFlags -version

虽然能正确打印出参数信息：

-XX:InitialHeapSize=999999999 -XX:MaxHeapSize=9999999999 -XX:+PrintCommandLineFlags -XX:+UseCompressedClassPointers -XX:+UseCompressedOops -XX:-UseLargePagesIndividualAllocation -XX:+UseParallelGC 

问题排查

但是我的MainClass中的调试信息却无法打印出来，这就导致使用该参数时我的MainClass好像没有被执行，通过以下步骤寻找问题可能出现的点：

1. 单独运行main方法；
2. 添加-version参数后运行；
3. 对比输出差异。

原因分析

怀疑是 -version的锅，仔细查了一下资料，还真是如此：

• -version 的行为是“打印版本信息并立即退出 JVM”。这是它的设计目的。
• 当 java 命令行中包含 -version 时，JVM 在完成版本信息的打印后，生命周期就结束了。它不会进行类加载、链接、初始化，更不会查找和执行任何 main 方法。
• 因此，任何放在 -version 之后的类名或参数，都不会导致该类的 main 方法被执行。
• 想要执行 main 方法，1.) 必须去掉 -version 参数。应该在 IDE 的 VM Options 中配置 -XX:+PrintCommandLineFlags 或2.) 使用 -XX:+PrintCommandLineFlags -showversion 来兼顾处理。

解决方案

1.不加 -version参数

于是进行尝试，如果舍弃环境信息，只需要看到堆栈信息以及其他参数信息，那么可以采用不加：-version参数的方案来实现，这样既可以打印出堆栈及参数信息，又可以执行到MainClass中的代码，即：

-XX:+PrintCommandLineFlags

输出结果：

-XX:InitialHeapSize=999999999 -XX:MaxHeapSize=9999999999 -XX:+PrintCommandLineFlags -XX:+UseCompressedClassPointers -XX:+UseCompressedOops -XX:-UseLargePagesIndividualAllocation -XX:+UseParallelGC 
=== Main 方法开始执行 ===
//...
=== Main 方法执行结束 ===

2.使用 -showversion参数实现

但是，我既想在主类启动时输出环境版本信息并且还想执行主类中的程序，这个该如何实现呢？答案是通过另一个参数来实现： -showversion。

虽然在通常情况下，-version（以及 -showversion）会强制 JVM 在完成其“元信息打印”任务后立即退出，不会进入正常的 Java 应用程序执行流程，但当 -showversion 被用作应用程序启动的一部分时（即，它出现在 java 命令行中，后面跟着主类），它会在启动应用程序之前打印版本信息，然后继续执行 main 方法。也就是说，-showversion 有“非终结”模式：当用于正常启动应用时，-showversion 只是提前打印版本信息，不影响 main 方法的执行。这是它与 -version 的关键区别。

在正常的 Java 应用程序启动命令中使用 -showversion（即后面跟着主类）时，它的流程是：

1. 启动 JVM；
2. 在加载主类和执行 main 方法之前，打印 Java 版本信息到控制台；
3. 继续正常的启动流程：加载指定的主类，调用其 main 方法，执行您的应用程序代码；
4. 应用程序执行完毕后，JVM 正常退出。

-showversion 只是一个“在启动早期打印一下版本”的标志，它不会终止 JVM。

再次尝试：

-XX:+PrintCommandLineFlags -showversion

输出结果：

-XX:InitialHeapSize=999999999 -XX:MaxHeapSize=9999999999 -XX:+PrintCommandLineFlags -XX:+UseCompressedClassPointers -XX:+UseCompressedOops -XX:-UseLargePagesIndividualAllocation -XX:+UseParallelGC 
java version "1.8.0_xxx"
Java(TM) SE Runtime Environment (build 1.8.0_xxx-xxx)
Java HotSpot(TM) 64-Bit Server VM (build xx.xxx-xxx, mixed mode)

=== Main 方法开始执行 ===
//...
=== Main 方法执行结束 ===

问题得到解决，这样使用该参数，在开发和调试环境中，它能同时提供：

• JVM 配置的透明度：通过 PrintCommandLineFlags 看到实际生效的参数。
• 环境信息：通过 showversion 确认当前运行的 JDK 版本。
• 完整的应用程序执行： main 方法代码会正常运行并输出结果。

这比单独使用 PrintCommandLineFlags 提供了更多的诊断信息，是一个兼顾多个需求的解决方案。

总结

最后，做个小口诀加强记忆：

• 用 -version？ -> 只看版本，JVM 退出。
• 用 -showversion？ -> 先看版本，再跑程序。

误区

• 认为 PrintCommandLineFlags 会阻止 main 执行 —— 真正“杀手”是 -version。
• 混淆 -version 与 -showversion —— 一字之差，行为天壤之别。