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

[1.jenkins.util.SystemProperties $Listener错误](#1.jenkins.util.SystemProperties$ Listener错误)

[2.java.lang.RuntimeException: Fontconfig head is null, check your fonts or fonts configuration](#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](#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
登入jenkins，点击管理jenkins===》插件==》高级设置，替换升级站点的URL提交