docker springboot 验证码图片采坑记录 libawt_xawt.so X11GraphicsEnvironment

今天药忘吃喽~ 2021-11-27 07:16 167阅读 0赞

首先，生成图片验证码用的还是普天的 awt 包，Dockerfile 基础镜像用的是 `FROM docker.io/store/oracle/serverjre:8`  
开始出现了下面的错误：

java.lang.UnsatisfiedLinkError: /usr/java/jdk1.8.0_211/jre/lib/amd64/libawt_xawt.so: libXext.so.6: cannot open shared object file: No such file or directory

于是乎，进入基础镜像 `docker.io/store/oracle/serverjre:8` 后执行下面的命令，然后将镜像重新 commit 了一个包，解决了问题：

yum install libXext.x86_64 -y
    yum install libXrender.x86_64 -y
    yum install libXtst.x86_64 -y

新的镜像我命名为 `docker.io/xzxiaoshan/java-serverjre:8` 此时，该镜像中，包含了刚刚安装的3个内容。

然后重新打包镜像，再次执行，又出现错误：

java.awt.AWTError: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.
    或者
    java.lang.NoClassDefFoundError: Could not initialize class sun.awt.X11GraphicsEnvironment

往上查了，各种说加什么 JAVA\_OPTS headless 为 true 的，在基于 docker springboot 的都不好使。  
我还是从代码层面手工设置了 `System.setProperty("java.awt.headless","true");` 直接解决问题。  
说明：  
什么是Headless mode？Headless模式是系统的一种配置模式。在该模式下，系统缺少了显示设备、键盘或鼠标。  
一般是在程序开始激活headless模式，告诉程序，现在你要工作在Headless mode下，就不要指望硬件帮忙了，自力更生并依靠系统的计算能力模拟出这些特性来。

/**
     * 主程序
     * 
     * @author 单红宇
     * @date   2019年6月19日
     *
     */
    @SpringBootApplication
    public class StartApplication {
    
    	/**
    	 * 程序入口
    	 * 
    	 * @param args
    	 */
    	public static void main(String[] args) {
    		System.setProperty("java.awt.headless","true");
    		SpringApplication.run(StartApplication.class, args);
    	}
    
    }

（END）