EasyExcel项目部署Linux服务器上报错空指针异常
问题描述
博主的Spring项目中有个接口功能是接收数据，并通过EasyExcel写入相关数据并返回数据流。在本地已经完成开发，测试也并没有什么问题，于是并通过docker构建镜像并部署到Linux服务器上，构建镜像的dockerfile如下：
1 | FROM openjdk:8-alpine |
采用的是java:8-alpine的基础镜像，运行容器，没有啥问题。
但是博主测试刚才说的EasyExcel生成excel表格的接口时，却发生了错误，在浏览器开发者工具栏网络里面查看发现报错结果：
错误码为500的内部服务器异常，异常类型是：java.lang.NullPointerException，也就是空指针异常，而且报错信息竟然是无可用信息。
问题分析
那从浏览器日志根本看不出是什么原因造成了这个接口的错误。那么就看后台的日志吧，因为是通过docker部署的，那么直接logs查看日志：
1 | 2024-04-19 02:50:41.240 ERROR 7 --- [nio-8190-exec-4] o.a.c.c.C.[.[.[/].[dispatcherServlet] : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is java.lang.NullPointerException] with root cause |
从异常抛出栈来看，是由于FontConfiguration这个类报错产生的，而且它又在图像库awt下，结合它的名字，应该是和字体相关的吧，这个时候我又想到我的项目是在docker里面运行的，而且还是alpine类型的精简系统，是不是字体缺失造成的？在调用栈里面也可以明显看到有个readFontConfigFile的方法，看名字应该就是读取系统字体配置吧。
那么进行尝试吧：
先进入docker容器：
1 | docker exec -it <容器名> sh |
本来想看看系统里有啥字体的，执行:
1 | fc-list |
结果说没这个命令，那也就是fontconfig也没有装吧。
那在Alpine Linux里面apk应该总有吧：
那有apk就好办呐，先换个中科大源：
1 | sed -i 's/http:\/\/dl-cdn.alpinelinux.org/https:\/\/mirrors.ustc.edu.cn/g' /etc/apk/repositories |
先装个fontconfig来看看字体吧：
1 | apk add fontconfig |
再看看有啥字体吧:
1 | fc-list |
结果输出直接为空，也就是说这个精简系统里面啥字体都没有呐！
那么装上基础字体试试：
1 | apk add ttf-dejavu |
再更新一下字体缓存：
1 | mkfontscale && mkfontdir && fc-cache |
再退到宿主机，重启一下容器，发现接口能正常访问了。
问题解决
结合上面的分析，可以知道，问题的根源就是：alpine的精简系统里面缺失基础字体！
所以这个锅应该由docker的镜像来背，而不是EasyExcel运行在Linux系统上本身就有啥问题，针对于此，解决的方法也有很多：
不使用精简版的
alpine基础镜像，而是使用功能齐全的其他镜像，比如把openjdk:8-alpine换成openjdk:81
2
3
4
5
6
7
8#采用环境齐全的镜像
FROM openjdk:8
ARG JAVA_OPTS="-Xmx128M"
ENV JAVA_OPTS=$JAVA_OPTS
ENV RUN_ARGS=$RUN_ARGS
WORKDIR service
ADD target/app.jar app.jar
ENTRYPOINT ["sh","-c","java $JAVA_OPTS -jar app.jar $RUN_ARGS"]2像我上面分析的那样，镜像里面自己下个基础字体的包，但是肯定不能真像我那样部署好了再进入容器里面搞，不能每次部署都要自己操作一遍吧。因此更好的解决方法是
dockerfile里面加入我刚才执行的命令，自己封装一个镜像：1
2
3
4
5
6
7
8
9FROM openjdk:8-alpine
ARG JAVA_OPTS="-Xmx128M"
ENV JAVA_OPTS=$JAVA_OPTS
ENV RUN_ARGS=$RUN_ARGS
RUN sed -i 's/http:\/\/dl-cdn.alpinelinux.org/https:\/\/mirrors.ustc.edu.cn/g' /etc/apk/repositories && apk update
RUN apk add ttf-dejavu fontconfig && rm -rf /var/cache/apk/* && mkfontscale && mkfontdir && fc-cache
WORKDIR service
ADD target/app.jar app.jar
ENTRYPOINT ["sh","-c","java $JAVA_OPTS -jar app.jar $RUN_ARGS"]
两种方法都行吧，图省事其实还是第一种方法好，换个镜像就解决问题了，但是相应的可能构建的镜像稍微大了一点。
顺便引用一下普通镜像和alpine版本镜像有何区别：
openjdk:x-alpine和openjdk:x镜像之间的主要区别在于基础操作系统的不同：
- openjdk:x-alpine： 这个镜像基于 Alpine Linux 发行版构建。Alpine Linux 是一个轻量级的 Linux 发行版，专注于简洁和精简，因此
openjdk:x-alpine镜像通常比较小，体积更小，适合用于构建轻量级的 Docker 容器。Alpine Linux 使用muslC 库替代了传统的glibc，并使用apk包管理器来管理软件包。- openjdk:x： 这个镜像通常基于常见的 Linux 发行版，如 Ubuntu、Debian、CentOS 等。这些发行版通常包含了更多的软件包和工具，因此
openjdk:x镜像的体积通常比较大。与 Alpine Linux 不同，这些常见的 Linux 发行版使用传统的glibcC 库，并使用apt（或者apt-get）包管理器（在 Debian/Ubuntu 等）或者yum包管理器（在 CentOS/RHEL 等）来管理软件包。
