AWS Lambda 上的字型顯示錯誤

Curtis Chau

更新:2025年6月1日

Translated

View the article in English

在 Linux 系統中渲染 PDF 文件可能會導致字元顯示錯誤，如下圖所示。有時在 Windows 環境下字元顯示正常，但在 Linux 環境下卻不行。

破碎字元

原因

原因是作業系統中缺少該字體。

解決方案

如果您已經知道字體名稱，那就太好了—您可以跳過步驟 1。

若要尋找字型名稱，請嘗試在 Windows 上渲染 HTML，並使用 Adobe 檢查字元。
一旦確定了字體名稱，就可以從網路上下載字體文件，例如從Google Fonts下載。
若要透過 Dockerfile 新增和安裝字體，請將字型檔案放入專案中，並將"複製到輸出目錄"設定為"始終複製"。接下來，使用以下程式碼在 Dockerfile 中新增和安裝字型：

# Copy the Cambria Math font into the container
# Ensure the font file (cambria.ttc) exists in your project directory
COPY cambria.ttc /usr/share/fonts/

# Install fontconfig to update the font cache
# This will install fontconfig and refresh the font cache to recognize the newly added fonts
RUN dnf install -y fontconfig && \
    fc-cache -fv

解釋

COPY cambria.ttc /usr/share/fonts/ : 此行將 Cambria Math 字體從您的專案目錄複製到容器的字體目錄中。請確保字型檔案(cambria.ttc)存在於專案目錄中。
RUN dnf install -y fontconfig && \ : 此命令安裝 fontconfig 軟體包，該軟體包是管理和配置 Linux 中字體存取所必需的。 -y 標誌會自動確認軟體包的安裝。
fc-cache -fv ：此指令更新字體緩存，確保容器內的應用程式可以使用新複製的字體。標誌 -f (force) 和 -v (verbose) 分別用於強制重新產生快取和提供詳細輸出。