解决JDK17 java.lang.UnsatisfiedLinkError: /opt/jdk17/lib/libfontmanager.so: libfreetype.so.6

最新推荐文章于 2025-06-23 17:26:34 发布
最新推荐文章于 2025-06-23 17:26:34 发布
阅读量1.3k 收藏
点赞数 3
CC 4.0 BY-SA版权
分类专栏： 精选实践 文章标签： java 开发语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/SJshenjian/article/details/141070828

1. 现象描述

本地开发EasyExcel导出无问题，K8S发布后导出报错。

2. 原因分析

镜像依赖于FROM openjdk:17-jdk-alpine-utf8，属于精简版。

3. 问题解决

在项目Dockerfile中新增命令安装字体即可

RUN apk --no-cache add fontconfig ttf-dejavu

ps: 我尝试在基础镜像openjdk:17-jdk-alpine-utf8中加入该命令构建，项目进行依赖，还是报错，感觉没有存储，不知哪位大佬解释下原因几何

Docker容器运行java11应用EasyExcel导出报错 libfreetype.so.6共享库
zxstrive的专栏
03-31 2560
镜像解决中文和freetype.so.6共享库找不到的问题，基于oracle jdk11.0.18 Docker镜像。
正确解决java.lang.UnsatisfiedLinkError异常的有效解决方法
wbajsjhhhhh的博客
05-12 5320
正确解决java.lang.UnsatisfiedLinkError异常的有效解决方法
jenkins 启动报错
liudongyang123的博客
05-09 711
安装完成之后重启jenkins。
Docker下openjdk:17环境缺失字体文件
最新发布
Why9310的博客
06-23 238
java.lang.UnsatisfiedLinkError: /usr/local/jdk17/lib/libfontmanager.so: libfreetype.so.6: 无法打开共享对象文件没有这样的文件或目录。在dockerfile中增加以下命令。
使用阿里easyexcel进行导出时报错:(libharfbuzz.so.0: 无法打开共享对象文件)的处理
xyzcto的博客
08-16 616
原因是缺少libharfbuz库。
处理fontmanager (libfreetype.so.6: cannot open shared object file: No such file or directory）问题
Lidp_的博客
07-22 1942
记录问题处理fontmanager (libfreetype.so.6: cannot open shared object file: No such file or directory）ai找到的解决方案：（docker镜像启动相当久，不推荐）内容过于精简，缺少字体，导致Excel导出文件为空。解决方案大致两种： 换镜像，自己补全所需要的内容。找一个内容资源比较全的jdk镜像，上传。解决，不会导致镜像开启时间过长的问题。在使用docker创建镜像使用。
解决JDK17/21 java.lang.UnsatisfiedLinkError: /usr/local/jdk17/lib/libfontmanager.so: libfreetype.so.6
专注于Java架构学习 https://gitee.com/laokouyun https://github.com/KouShenhai
10-10 1万+
java.lang.UnsatisfiedLinkError: /usr/local/jdk17/lib/libfontmanager.so: libfreetype.so.6: 无法打开共享对象文件没有这样的文件或目录。字体直接从win11复制字体放进来即可，不知道咋搞的直接私信老夫。本人Dockerfile脚本（小伙伴们，你们好呀，我是老寇。写的不是优雅 0.0。
Caused by: java.lang.UnsatisfiedLinkError...解决经历
weixin_33788244的博客
03-01 873
Caused by: java.lang.UnsatisfiedLinkError: Couldn't load BaiduMapVOS_v2_1_3: findLibrary returned null在使用百度地图的时候碰到了这问题 网上搜了下各种方法 都不顶用 我想死的心都有了。。有没有碰到过这问题的 求分享下经验啊。。。。。。。。 后来看了百度地图sdk的demo以后，是因为有一个文件 ...
【Java报错已解决】java.lang.UnsatisfiedLinkError
鸽芷咕的博客
11-10 6586
在Java开发的世界里，我们时常会遇到各种各样的报错，其中java.lang.UnsatisfiedLinkError就像一个隐藏在暗处的幽灵，常常让开发者和环境配置者们感到困惑和无奈。这个错误一旦出现，可能会使我们精心编写的Java程序戛然而止，严重影响项目的开发进度和稳定性。那么，这个神秘的UnsatisfiedLinkError究竟是如何产生的？又该如何有效地解决它呢？让我们一起深入探究这个恼人的报错问题。
java.lang.UnsatisfiedLinkError: /usr/local/openjdk-11/lib/libfontmanager.so
zbh1957282580的博客
05-11 5978
1：先看一下异常是不是符合你的异常 com.alibaba.excel.exception.ExcelGenerateException: java.lang.UnsatisfiedLinkError: /usr/local/openjdk-11/lib/libfontmanager.so: libfreetype.so.6: cannot open shared object file: No such file or directory at com.alibaba.excel.write.Exc
libfreetype.so.6: cannot open shared object file: No such file or directory
qq_43615820的博客
01-04 4974
【代码】./TeamServerImage: error while loading shared libraries: libfreetype.so.6: cannot open shared object file: No such file or directory。
无法加载验证码libfreetype.so.6: cannot open shared object file: No such file or directory
Sherry
09-07 4682
无法加载验证码libfreetype.so.6: cannot open shared object file: No such file or directory
java 17运行jar报错：java.lang.UnsatisfiedLinkError: Can‘t load library:
ZEEKLING
09-17 2171
于是重新安装了下openjdk17。发现jar包也能正常运行了。此时发现这个文件存在了。
Caused by: java.lang.UnsatisfiedLinkError: Cannot load library
Technology is fun, sharing is kind.
02-23 3555
when I tried to package an old cocos2dx NDK project, I encountered this problem, apk could be exported but crashed when start running it. Here is the log I get from eclipse logcat: FATAL EXCEPTION
centos7.6安装jmeter5.5使用JDK11时报错：java.lang.UnsatisfiedLinkError: /opt/jdk-11.0.17/lib/libawt_xawt.so:
weixin_42484338的博客
01-16 664
配置好JDK11环境变量和jmeter环境变量后。输入jmeter报错，/opt/jdk-11.0.17/lib/libawt_xawt.so: libXtst.so.6: 无法打开共享对象文件: 没有那个文件或目录
已解决java.lang.UnsatisfiedLinkError异常的正确解决方法，亲测有效！！！
热门推荐
小明的Java问道之路
01-29 11万+
已解决java.lang.UnsatisfiedLinkError异常的正确解决方法，亲测有效！！！
java docker容器给图片设置水印/opt/openjdk-17/lib/libfontmanager.so: Error loading shared library libfreetype.
abments的博客
12-06 410
java docker容器给图片设置水印/opt/openjdk-17/lib/libfontmanager.so: Error loading shared library libfreetype.（中文出现小方框）
Handler dispatch failed; nested exception is java.lang.UnsatisfiedLinkError: /home/work/java/lib/libfontmanager.so: libfreetype.so.6: cannot open shared object file: No such file or directory
03-21
<think>好的，我现在需要解决用户遇到的java.lang.UnsatisfiedLinkError错误，具体是缺少libfreetype.so.6文件的问题。首先，我要回忆一下这个错误的常见原因和解决方法。根据用户提供的引用信息，问题通常与JDK的版本有关，尤其是使用了精简版的JDK，比如Alpine Linux的镜像，这些镜像可能缺少一些依赖库。 首先，我应该确认用户使用的JDK版本和环境。用户提到引用了JDK11和JDK17的问题，特别是基于Alpine的镜像。Alpine Linux使用musl libc而不是glibc，并且为了减小镜像体积，可能没有包含某些库文件，比如libfreetype。而libfreetype是处理字体所需的库，缺少它会导致libfontmanager.so无法找到依赖，从而抛出UnsatisfiedLinkError。 接下来，解决方案可能包括安装缺失的依赖库。在Alpine中，可以通过apk包管理器来安装。比如安装freetype库，可能需要运行`apk add freetype`。此外，可能还需要其他相关依赖，比如fontconfig，所以用户可能需要同时安装这些包。 另外，用户可能使用的是Docker镜像，因此建议他们修改Dockerfile，在安装JDK之后添加安装这些依赖的步骤。例如，在基于openjdk:17-jdk-alpine的镜像中，添加`RUN apk add --no-cache freetype fontconfig`。 还有一种可能是用户使用的JDK版本本身有问题，比如简易版或精简版。这时候建议切换到更完整的JDK发行版，比如使用Debian/Ubuntu为基础的镜像，或者使用官方提供的包含更多依赖的JDK版本。例如，改用`openjdk:17-jdk-slim`或`openjdk:17-jdk`而不是alpine版本。 我需要确保提供的步骤清晰，并且覆盖不同情况。比如，对于Alpine用户，安装依赖；对于其他环境，可能也需要类似的步骤，或者建议更换基础镜像。此外，需要提醒用户验证安装后的结果，确保库文件确实存在，并且路径正确。 可能还需要检查libfreetype.so.6是否被正确链接，有时候安装的版本可能不同，导致符号链接问题。这时候可能需要手动创建链接，或者安装兼容的版本。 最后，总结解决方案，分步骤说明，确保用户能够按照指导操作，并测试应用是否解决了错误。</think>### 解决方案：修复`java.lang.UnsatisfiedLinkError`缺少`libfreetype.so.6` #### **问题原因** 该错误通常由以下原因导致： 1. **精简版JDK镜像**（如Alpine Linux的`openjdk:xx-jdk-alpine`）缺少字体渲染依赖库[^2]。 2. **未安装`libfreetype`库**：`libfontmanager.so`依赖此库处理字体渲染[^1]。 3. **系统环境配置不完整**：基础镜像未包含必要的图形/字体组件。 --- #### **解决步骤** ##### 1. 安装缺失的依赖库（Alpine Linux） 若使用Alpine Linux镜像（如`openjdk:17-jdk-alpine`），在Dockerfile中添加以下命令： ```dockerfile # 安装freetype、fontconfig及相关依赖 RUN apk add --no-cache freetype fontconfig ttf-dejavu ``` - `freetype`：提供`libfreetype.so.6` - `fontconfig`：管理字体配置 - `ttf-dejavu`：基础字体文件 ##### 2. 验证库文件路径 构建镜像后，进入容器检查库文件是否存在： ```bash # 查找libfreetype.so.6 find / -name "libfreetype.so*" 2>/dev/null # 输出示例： # /usr/lib/libfreetype.so.6.19.0 # /usr/lib/libfreetype.so.6 ``` ##### 3. 更换基础镜像（备用方案） 若问题持续，改用完整版JDK镜像（如Debian系）： ```dockerfile FROM openjdk:17-jdk-slim # 或 openjdk:17-jdk ``` --- #### **完整Dockerfile示例** ```dockerfile FROM openjdk:17-jdk-alpine # 安装字体相关依赖 RUN apk add --no-cache freetype fontconfig ttf-dejavu # 复制应用并启动 COPY app.jar /app.jar CMD ["java", "-jar", "/app.jar"] ``` --- #### **附加说明** - **Alpine镜像精简特性**：Alpine的`musl libc`和最小化设计可能导致依赖缺失，需手动补充。 - **JDK版本兼容性**：JDK 11/17均可能触发此问题，解决方案通用[^1]。 ---
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

算法小生Đ

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值