Jenkins: fontconfig head is null, check your fonts or fonts configuration；

最新推荐文章于 2025-06-05 15:18:52 发布

希斯克利夫27

最新推荐文章于 2025-06-05 15:18:52 发布

阅读量2.6k

点赞数 5

CC 4.0 BY-SA版权

文章标签： jenkins 运维

本文链接：https://blog.youkuaiyun.com/wonbin2011/article/details/142635307

在部署jenkins第一次启动时遇到如下报错：
在这里插入图片描述

一大串报错，看的让人脑瓜疼。。。静静地分析一下日志，发现第一行报错信息： fontconfig head is null, check your fonts or fonts configuration。

这是个什么鬼，我也不造，在网上搜的解决办法如下：

“Jenkins fontconfig head is null, check your fonts or fonts configuration” 这条错误信息通常表示 Jenkins 在加载或找到渲染文本所需的字体时遇到了问题，这种情况通常发生在运行图形应用程序或生成嵌入文本的报告时，尤其是在无头环境（如 CI/CD 管道）中，那里没有图形用户界面。

以下是一些解决该问题的方法：

1. 安装所需的字体

确保在运行 Jenkins 的系统上安装了所需的字体。在基于 Debian 的系统（如 Ubuntu）上，你可以使用以下命令安装一组常用字体：
```
sudo apt-get install -y fonts-dejavu-core fonts-freefont-ttf
```
在基于 Red Hat 的系统上，使用以下命令：
```
sudo yum install -y dejavu-sans-fonts
```

2. 验证 Fontconfig 的安装

确保 fontconfig 已正确安装和配置。fontconfig 是一个允许程序访问和管理字体数据的库。你可以使用以下命令安装它：
```
sudo apt-get install -y fontconfig
```
运行以下命令检查 fontconfig 是否可以正确检测到字体：
```
fc-list
```
该命令应列出系统上所有可用的字体。如果没有列出，则可能是字体配置出现了问题。

3. 手动设置字体路径

有时，显式设置字体路径可以解决问题。你可以通过将 FONTCONFIG_PATH 环境变量设置为包含字体配置文件的目录来实现：
```
export FONTCONFIG_PATH=/etc/fonts
```

4. 配置 Jenkins 使用无头模式

如果问题是由于 Jenkins 试图在无头环境中运行引起的，请确保你的 Java 应用程序配置为使用无头模式：
```
java -Djava.awt.headless=true -jar jenkins.war
```
你还可以将 -Djava.awt.headless=true 添加到 Jenkins 配置中的 JVM 选项。