基于tomcat运行jenkins常见的报错处理

1.jenkins.util.SystemProperties$Listener错误

升级jdk11可能遇到的坑

2.java.lang.RuntimeException: Fontconfig head is null, check your fonts or fonts configuration

3.There were errors checking the update sites: UnknownHostException:updates.jenkins.io

1.jenkins.util.SystemProperties$Listener错误

[root@master tomcat-8.5.98]# tail -10f logs/localhost.2024-02-06.log

rg.apache.catalina.core.StandardContext.listenerStart 配置应用程序监听器[jenkins.util.SystemProperties$Listener]错误
java.lang.UnsupportedClassVersionError: jenkins/util/SystemProperties$Listener has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0 (无法载入的类 [jenkins.util.SystemProperties$Listener])

错误消息指出jenkins.util.SystemProperties$Listener类是由更高版本的Java Runtime编译的（类文件版本55.0），而当前运行环境的Java Runtime只识别到版本52.0的类文件。

类文件版本55.0对应于Java 11，而版本52.0对应于Java 8。这意味着Jenkins WAR文件是为Java 11或更高版本编译的，而你的Tomcat服务器是在Java 8或更低版本的环境下运行的。

PS:当前系统为centos7，tomcat版本为8.5.98，jenkins的版本为2.426.3LTS，java8

可能单看tomcat服务的catalina.out日志看不出具体的问题，需要结合localhost日志排查

解决办法：升级java环境至11版本，即升级jdk11

jdk11下载地址（根据系统选择安装包）：Java Downloads | Oracle

升级jdk11可能遇到的坑

启动tomcat时直接报错：

The JRE_HOME environment variable is not defined correctly
JRE_HOME=/home/jdk11/jre
This environment variable is needed to run this program

这个错误消息表明系统中 JRE_HOME 环境变量没有被正确地定义。JRE_HOME 是一个环境变量，它指向 Java Runtime Environment (JRE) 的安装目录。当尝试运行某些 Java 程序或工具时，它们可能需要这个环境变量来找到正确的 JRE 安装位置。

PS：默认的jdk11目录下没有jre文件

[root@master ~]# cd /usr/local/jdk11/
[root@master jdk11]# ll -h
总用量 24K
drwxr-xr-x 2 root root 4.0K 2月 6 11:04 bin
drwxr-xr-x 4 root root 112 2月 6 11:04 conf
drwxr-xr-x 3 root root 132 2月 6 11:04 include
drwxr-xr-x 2 root root 4.0K 2月 6 11:04 jmods
drwxr-xr-x 72 root root 4.0K 2月 6 11:04 legal
drwxr-xr-x 6 root root 4.0K 2月 6 11:04 lib
drwxr-xr-x 3 root root 18 2月 6 11:04 man
-r--r--r-- 1 10668 10668 160 12月 20 06:09 README.html
-rw-r--r-- 1 10668 10668 1.3K 12月 20 06:09 release

解决：进入jdk11目录下，执行如下命令：

./bin/jlink --module-path jmods --add-modules java.desktop --output jre

[root@master jdk11]# ll -h
total 24K
drwxr-xr-x 2 root root 4.0K Feb 6 14:23 bin
drwxr-xr-x 4 root root 112 Feb 6 14:23 conf
drwxr-xr-x 3 root root 132 Feb 6 14:23 include
drwxr-xr-x 2 root root 4.0K Feb 6 14:23 jmods
drwxr-xr-x 8 root root 94 Feb 6 15:08 jre
drwxr-xr-x 72 root root 4.0K Feb 6 14:23 legal
drwxr-xr-x 6 root root 4.0K Feb 6 14:23 lib
drwxr-xr-x 3 root root 18 Feb 6 14:23 man
-r--r--r-- 1 10668 10668 160 Dec 20 06:09 README.html
-rw-r--r-- 1 10668 10668 1.3K Dec 20 06:09 release

之后可在/etc/profile文件添加环境变量（根据实际情况添加）：

export JAVA_HOME=/path/jdk11

export JRE_HOME=/path/jdk11/jre # 替换为实际的JRE路径

export PATH=$JRE_HOME/bin:$PATH

2.java.lang.RuntimeException: Fontconfig head is null, check your fonts or fonts configuration

解决办法：

1.可以连接互联网的情况下

yum install -y fontconfig，再重新启动tomcat

2.无法连接互联网

找一台可以连接互联网的机器，仅下载fontconfig的rpm包及其依赖包

yumdownloader --resolve --destdir=/root/java/ fontconfig dejavu-sans-fonts fontpackages-filesystem libexpat.so.1 libfreetype.so.6 libuuid.so.1

下载好后，打包成tar包，上传到jenkins服务器上并解压安装（可能环境不同，所需的依赖包也不一致，根据提示安装即可），再重新启动tomcat后，可正常访问登入Jenkins

[root@maste java]# rz
[root@maste java]# rpm -ivh --force ./*.rpm
Preparing... ################################# [100%]
Updating / installing...
1:fontpackages-filesystem-1.44-8.el################################# [ 10%]
2:dejavu-fonts-common-2.33-6.el7 ################################# [ 20%]
3:dejavu-sans-fonts-2.33-6.el7 ################################# [ 30%]
4:libuuid-2.23.2-65.el7_9.1 ################################# [ 40%]
5:libpng-2:1.5.13-8.el7 ################################# [ 50%]
6:expat-2.1.0-15.el7_9 ################################# [ 60%]
7:bzip2-libs-1.0.6-13.el7 ################################# [ 70%]
8:freetype-2.8-14.el7_9.1 ################################# [ 80%]
9:fontconfig-2.13.0-4.3.el7 ################################# [ 90%]
10:fontconfig-2.13.0-4.3.el7 ################################# [100%]

3.There were errors checking the update sites: UnknownHostException:updates.jenkins.io

出现 "There were errors checking the update sites: UnknownHostException: updates.jenkins.io" 错误通常意味着 Jenkins 无法连接到 updates.jenkins.io，这可能是由于网络问题、DNS 解析问题、代理设置不正确、或者 updates.jenkins.io 暂时不可访问。

可能是你本地的网络环境无法访问外网

解决方法：

1.检查网络、DNS

2.更换Jenkins 更新站点配置，默认的jenkins更新站点是国外的，可能无法访问，可更换国内的更新站点，如：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json