docker部署使用EasyExcel导出因未安装中文字体报错及处理方法

最新推荐文章于 2025-04-02 19:28:55 发布

JaxBZD

最新推荐文章于 2025-04-02 19:28:55 发布

阅读量2.8k

点赞数

文章标签： docker 运维 linux spring boot

本文链接：https://blog.youkuaiyun.com/qq_33538248/article/details/127685062

版权

当Spring Boot应用在Docker环境下使用EasyExcel导出表格时，由于容器内缺少中文字体导致空指针异常。解决方法包括：将Windows的简体中文字体复制到Docker容器的字体目录，安装字体并更新缓存，最后重启容器使字体生效。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

场景

本地使用EasyExcel模板方式导出表格无问题，当项目打包成docker镜像运行时报空指针异常，具体提示找不到字体，错误如下。

错误原因

原因是docker容器中没有安装中文字体，导出时获取不到字体报空指针异常。

处理方法

本处理方法时手动规避方法，可以根据以下步骤写成shell脚本，或者配置在DockerFile里面，是打包出来的镜像就是安装过中文字体的。本文仅展示手动规避方法，能更好的理解和扩展。

获取中文字体源文件

使用windows的简体中文字体即可，具体方法如下

1.win+r输入fonts

2. 找出图标为简体字的字体，上传到linux主机任意目录下

3.进入docker bash创建对应字体目录，并将字体从linux主机复制到docker容器字体目录中

最低0.47元/天解锁文章

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

JaxBZD

关注关注

0
点赞
踩
2

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

Docker容器运行java11应用EasyExcel导出报错 libfreetype.so.6共享库

zxstrive的专栏

03-31

2452

镜像解决中文和freetype.so.6共享库找不到的问题，基于oracle jdk11.0.18 Docker镜像。

easy excel导出文档功能，部署docker容器时报错解决

qq_35698970的博客

10-26

1163

easy excel部署到docker容器报错

参与评论您还未登录，请先登录后发表或查看评论

docker打包镜像后EasyExcel报错，dockerfile缺少字体

m0_55600787的博客

12-06

1883

EasyExcel读取数据失败的常见问题之缺少字体

openjdk:8u22-jre-alpine在java开发中的NullPointerException错误解决方案

weixin_30521161的博客

08-09

625

问题描述 ** 在SpringBoot项目中使用了Ureport报表组件, 打包发布部署到docker中启动报错 ** java.lang.NullPointerException at sun.awt.FontConfiguration.getVersion(FontConfiguration.java:1264) at sun.awt.FontConfiguratio...

在Linux运行没问题，但是在docker中运行程序，报错：could not initialize class sun.awt.X11FontManagager

最新发布

weixin_38203586的博客

04-02

268

在Linux运行没问题，但是在docker中运行程序，报错：could not initialize class sun.awt.X11FontManagager

EasyExcel缺少字体导出报错（记录下方便下次查找)

zhanghua0324的博客

03-30

885

1.安装字体包： yum -y install fontconfig。3.查看字体是否安装成功(有一种即可)： fc-list。2.刷新内存中的字体缓存： fc-cache。原因：服务器上没有安装字体包。

解决Docker缺少字体导致Easyexcel无法导出的问题

繁星、晚风

04-11

829

java导出excel

解决docker中Easyexcel因缺少字体无法导出的问题

qq_39624298的博客

06-29

1805

错误信息是 Docker坑Alpine没有自带默认字体造成的解决方案在 Dockerfile 中进行修改，增加如下内容 ENV LANG en_US.UTF-8 RUN apk add --update ttf-dejavu fontconfig && rm -rf /var/cache/apk/* 我们公司使用的是使用maven方式 dockerfile远程打包镜像 ...

excel导出在docker环境中总是失败的问题

01-09

excel导出在docker环境中总是失败，最直接的原因还是因为没有安装中文字体，解决方法如下： DOCKER环境中没有安装中文字体，需要安装 java.lang.NullPointerException: null 2020/5/29 上午8:40:11 at sun.awt.FontConfiguration.getVersion(FontConfiguration.java:1264) 2020/5/29 上午8:40:11 at sun.awt.FontConfiguration.readFontConfigFile(FontConfiguration.java:219) 2020

docker环境下 easyExcel导出错误

墨染秦时的博客

05-22

1244

docker环境下easyExcel导出错误

EasyExcel导出缺少字体库

03-25

当使用 EasyExcel 进行文件导出操作时，如果运行环境（如 Linux 或 Docker 容器）未安装必要的字体支持，则可能会引发 `FontConfiguration` 错误或其他与字体相关的异常。以下是针对不同场景的具体解决方案。 #### ...

使用easyExcel框架报错：服务器缺少字体

一瓢西湖水的博客

11-30

1489

后台服务使用easyExcel框架生成表格，但是生成的时候报如下的错误：这种报错其实就是部署服务的服务器缺少字体，正确的方法是安装字体。需要注意的是，测试环境服务器与生产环境服务器的在配置版本上可能存在差异，因此需要提前比对，避免测试环境测试成功的操作步骤，但是在生产环境上运行时有问题。

解决Docker镜像缺少字体的问题

淋雨一直走啊

08-04

7739

最近在使用`spire.office.free`这个工具将Excel转换成Html时，后台总是报`Cannot found font installed on the system.宋体`这个错误，本地调试的好好的，docker运行总是报错

easyexecl导出100万行execl报字体错误的解决办法

keyboard专栏

06-27

1997

使用easyexecl做100万行csv的导出，会报两个错误，都是因为openjdk精简版安装到docker内部，缺少字体的问题。错误明细：或者需要重新做一个镜像，以openjdk17为例 2、IDEA配置docker插件安装步骤可以自己google一下安装配置及其注册，可以google查询或者配置依赖的镜像附注：esayExcel的导出代码...

java项目使用docker部署后EasyExcel异常

Jerry

08-11

500

java项目使用docker部署后EasyExcel异常，ExcelGenerateException: Create workbook failure，Caused by: java.lang.NullPointerException: null at sun.awt.FontConfiguration.getVersion(FontConfiguration.java:1264)

Linux字体缺失导致EasyExcel报错

LB_bei的博客

08-29

918

安装ttmkfdir，当你在 Linux 系统中加了新的字体，可以使用 ttmkfdir 生成相关的字体配置文件，使得字体能被 X11 系统识别和使用；系统未联网：最烦的就是版本问题，直接从官网下载版本一直冲突，于是我用另一个同样centos7系统下载下来包然后移到问题服务器；环境：centos7（华为云服务器），jdk17，springboot3。在问题服务器中创建文件夹，然后将字体文件移过来。easyExcel的配置中别忘了设置字体。回到windows系统找要用的字体。保存，然后刷新字体缓存。

EasyExcel缺少字体导出报错

csdn_CZQ的博客

11-15

4872

问题描述：使用easyexcel导出数据，开发、测试环境能正常导出，在生产导出时数据为空。代码FontConfiguration.getVersion处报空指针。报错信息： java.lang.InternalError: java.lang.reflect.InvocationTargetException com.alibaba.excel.exception.ExcelGenerateException: java.lang.InternalError: java.lang.reflect.I

easyexcel避免字体问题

08-19

为了避免EasyExcel在Docker镜像中出现字体问题，你可以按照以下步骤进行操作： 1. 在Dockerfile文件中，使用合适的基础镜像，例如openjdk:17-alpine。在该镜像上安装所需的字体库，例如ttf-dejavu和fontconfig。这可以通过在Dockerfile中添加以下指令实现： ``` FROM openjdk:17-alpine RUN apk add --update ttf-dejavu fontconfig && rm -rf /var/cache/apk/* ``` 这将确保所需的字体库被正确安装到Docker镜像中。 2. 如果你正在使用IDEA进行开发，你可以配置Docker插件来构建和运行Docker镜像。这将使你能够在IDEA中方便地进行Docker相关的操作。通过以上步骤，你可以避免EasyExcel在Docker镜像中出现字体问题，并确保应用程序能够正常导出表格。123 #### 引用[.reference_title] - *1* [docker部署使用EasyExcel导出因未安装中文字体报错及处理方法](https://blog.youkuaiyun.com/qq_33538248/article/details/127685062)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] - *2* *3* [easyexecl导出100万行execl报字体错误的解决办法](https://blog.youkuaiyun.com/sunyuhua_keyboard/article/details/125482353)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] [ .reference_list ]