理解环境变量 JAVA_TOOL_OPTIONS

JAVA_TOOL_OPTIONS是何物

有些应用不方便设置JVM参数，如命令行应用、通过JNI(Java Native Interface)API调用虚拟机的应用、脚本嵌入虚拟机中的应用等。这种情况环境变量JAVA_TOOL_OPTIONS就非常有用了，它会被JNI API的JNI_CreateJavaVM函数使用。

Note:
在有些场景为了安全考虑环境变量JAVA_TOOL_OPTIONS是被禁用的，比如Solaris系统中但有效用户ID或组ID不是实际ID时则禁用此环境变量。

因为JAVA_TOOL_OPTIONS是被被JNI_CreateJavaVM调用的，顾名思义是创建VM，因此有些参数是不能被设置的如选择虚拟机运行模式-client或-server。

各种OPTIONS的区别

也许你经常遇到JAVA_OPTS、_JAVA_OPTIONS和JAVA_TOOL_OPTIONS，那么他们有什么不同呢？

• JAVA_OPTS：常用于一些应用的配置，如Tomcat，但它一般不作为环境变量，也不能被JVM识别的，是那些应用的自定义配置；

• _JAVA_OPTIONS：也是作为环境变量来替代命令行参数的，但它是JVM厂家自定义的，可以覆盖JAVA_TOOL_OPTIONS，但各厂家的不同，_JAVA_OPTIONS是Oracle的JVM，而IBM的则是用IBM_JAVA_OPTIONS。

• JAVA_TOOL_OPTIONS：是标准的，所有虚拟机都能识别和应用的。

如果想验证上面的不同也不难，如果设置了JVM能识别的环境变量，JVM会有"Picked up"的提示的，如：

export JAVA_OPTS=zhaiqiafneng
export JAVA_TOOL_OPTIONS="-Xmx512m -Xms64m" 

java -version 

JVM会打印：

Picked up JAVA_TOOL_OPTIONS: -Xmx512m -Xms64m
java version "1.8.0_101"
Java(TM) SE Runtime Environment (build 1.8.0_101-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.101-b13, mixed mode)

可见JAVA_TOOL_OPTIONS能被JVM识别，而JAVA_OPTS不能被识别。

可以通过设置-Xmx的值触发“Too small initial heap”异常连检测覆盖(当然你也可以通过其他方式)：

export JAVA_TOOL_OPTIONS="-Xmx512m -Xms64m"
export _JAVA_OPTIONS="-Xmx1k -Xms1k"

java -version

JVM会打印

Picked up JAVA_TOOL_OPTIONS: -Xmx512m -Xms64m
Picked up _JAVA_OPTIONS: -Xmx1k -Xms1k
Error occurred during initialization of VM
Too small initial heap

可见_JAVA_OPTIONS覆盖了JAVA_TOOL_OPTIONS.

解决的经典问题

JAVA_TOOL_OPTIONS用于解决的经典问题是使用命令行导致中文乱码，如：

........
/HController.java:181: error: unmappable character for encoding GBK

                                    // ��?后的发�??
                                              ^

/HController.java:181: error: unmappable character for encoding GBK

                                    // ��?后的发�??
                                               ^

.......

通过设置环境变量JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF-8"一般可以解决，如果不能解决，就要根据你具体的编码来设置下就好。

---

更多原创文章可关注我的个人博客：宅前疯 或微信公众账号：zhaiqianfeng