No ‘ChromeSansMM’ font 错误解决

No ‘ChromeSansMM’ font 错误解决

错误

class com.spire.ms.System.Exception: No 'ChromeSansMM' font found!

背景

在使用 Spire.PDF 库处理 PDF 文件时，遇到了以下错误：

class com.spire.ms.System.Exception: No 'ChromeSansMM' font found!
com.spire.office.packages.sprlpw.spr—…—(Unknown Source)
...

这个错误表明应用程序在处理 PDF 文件时无法找到 ChromeSansMM 字体。经过调查，发现这个错误在我的开发环境（macOS）中不存在，但在 Docker 容器（基于 Ubuntu）中缺失。

解决方案

将 macOS 的所有字体复制到 Docker 镜像中。

导出 macOS 字体

mkdir ~/mac_fonts
cp -R /System/Library/Fonts/* ~/mac_fonts/
cp -R /Library/Fonts/* ~/mac_fonts/
cp -R ~/Library/Fonts/* ~/mac_fonts/

Dockerfile

Dockerfile基础镜像，将这些字体集成到 Docker 镜像中

# 使用 Ubuntu 作为基础镜像
FROM ubuntu:20.04

# 设置环境变量，防止交互式安装提示
ENV DEBIAN_FRONTEND=noninteractive

# 更新软件包列表并安装必要的软件包
RUN apt-get update && apt-get install -y \
    wget \
    curl \
    gnupg2 \
    software-properties-common \
    unzip \
    fontconfig  # 安装 fontconfig 包以便使用 fc-cache

# 创建字体目录并下载字体
RUN mkdir -p /usr/share/fonts/truetype/custom && \
    wget -O /usr/share/fonts/truetype/custom/Fonts.zip https://xxxxxx/Fonts2.zip && \
    unzip /usr/share/fonts/truetype/custom/Fonts.zip -d /usr/share/fonts/truetype/custom/ && \
    rm /usr/share/fonts/truetype/custom/Fonts.zip

# 刷新字体缓存
RUN fc-cache -fv

# 添加 OpenJDK 17 的 PPA
RUN add-apt-repository ppa:openjdk-r/ppa

# 安装 OpenJDK 17
RUN apt-get update && apt-get install -y openjdk-17-jdk

# 清理无用的文件和缓存
RUN apt-get clean && rm -rf /var/lib/apt/lists/*

# 设置 JAVA_HOME 环境变量
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

# 验证 Java 安装
RUN java -version

# 设置工作目录
WORKDIR /app

# 镜像不需要包含任何应用程序文件或启动命令

结论

通过将 macOS 的所有字体集成到 Docker 镜像中，成功解决了 No 'ChromeSansMM' font found 错误, 这种方法不仅解决了当前的问题，还确保了在处理其他 PDF 文件或生成图形时不会遇到类似的字体缺失问题。