Tomcat在Linux偶尔出现图片验证码不显示问题

问题描述

最近遇到一个比较奇怪的问题：

Tomcat Web应用发布到正式环境的Linux服务器，偶尔出现验证码显示不出来的问题，大部分情况下重启Tomcat服务就又好了，下次又有一定几率出现。

使用过easy-captcha和kaptcha都有一样的问题，应该和图形验证码库没有关系了：

<dependency>
    <groupId>com.github.whvcse</groupId>
    <artifactId>easy-captcha</artifactId>
</dependency>
<dependency>
    <groupId>com.github.penggle</groupId>
    <artifactId>kaptcha</artifactId>
</dependency>

重现问题

我们用测试服务器Tomcat多次重启终于有一个环境重现了问题，开启远程调试发现问题：

Could not initialize class java.awt.GraphicsEnvironment$LocalGE

java.lang.NoClassDefFoundError: Could not initialize class java.awt.GraphicsEnvironment$LocalGE

看起来似乎是有运行时的类没有找到，类找不到应该一直有问题，但是比较奇怪的是为什么重启就好了呢？

最后搜了一下发现其他也有人遇到类似问题：

https://community.jaspersoft.com/wiki/javalangnoclassdeffounderror-could-not-initialize-class-sunawtx11graphicsenvironment

https://dev.lucee.org/t/cfimage-suddenly-causes-could-not-initialize-class-java-awt-graphicsenvironment-after-updating-ubuntu-20-04-lts/7894

解决问题

按照上面收到的解决方案，添加JVM参数：

-Djava.awt.headless=true

https://blog.csdn.net/gg4236131/article/details/118639037

图片采用AWT图形处理并内存中生成，Java程序会去寻找Linux上的图形界面是否启动 ，如Linux缺少组件则, 缺少了显示设备、键盘或鼠标会报这个错误;
所以需要开启无头模式, Headless模式是系统的一种配置模式 , 开始激活Headless模式，告诉程序，现在你要工作在Headless mode下，就不要指望硬件帮忙了，你得自力更生，依靠系统的计算能力模拟出这些特性来继续。