Linux环境下JDK17结合Aspose保存PDF/Docx因缺失字体失败

错误原因分析 #

报错核心是JDK 17在Linux环境中无法加载字体配置，触发NullPointerException。仅安装fontconfig不足以解决问题，系统还需基础字体文件，且JDK需要正确识别字体缓存。

具体解决步骤 #

• 安装基础字体与fontconfig
  根据Linux发行版选择对应命令：

  • RHEL/CentOS系：yum install -y fontconfig dejavu-sans-fonts
  • Ubuntu/Debian系：apt update && apt install -y fontconfig fonts-dejavu-core
    DejaVu是通用无版权字体，可满足Aspose的字体渲染需求。

• 刷新字体缓存
  安装完成后执行以下命令强制生成字体缓存：

  fc-cache -fv
  

• 指定JDK字体配置路径（可选）
  如果JDK仍无法自动识别字体配置，启动Java程序时添加JVM参数：

  java -Dsun.awt.fontconfig=/etc/fonts/fonts.conf -jar your-application.jar
  

  /etc/fonts/fonts.conf是fontconfig默认配置文件路径，确保该文件存在。

• 验证字体配置
  执行fc-list命令查看系统已安装字体，若有输出则字体配置正常。也可通过简单Java代码验证：

  import java.awt.Font;
  import java.awt.GraphicsEnvironment;
  
  public class FontTest {
      public static void main(String[] args) {
          Font[] fonts = GraphicsEnvironment.getLocalGraphicsEnvironment().getAllFonts();
          System.out.println("可用字体数量: " + fonts.length);
          for (Font font : fonts) {
              System.out.println(font.getName());
          }
      }
  }
  

  编译运行后能输出字体列表，说明JDK字体加载正常。

• Docker环境优化
  在Dockerfile中整合安装与缓存步骤，避免容器启动后字体未生效：

  # CentOS/RHEL基础镜像示例
  RUN yum install -y fontconfig dejavu-sans-fonts && fc-cache -fv && yum clean all
  
  # Ubuntu/Debian基础镜像示例
  # RUN apt update && apt install -y fontconfig fonts-dejavu-core && fc-cache -fv && apt clean all
  

  添加yum clean all或apt clean all可减小镜像体积。

内容的提问来源于stack exchange，提问作者EH Sports