解决Docker镜像缺少字体问题

当在Docker容器中运行应用程序时遇到缺少字体的问题，通常是因为基础镜像中没有包含所需的字体文件。以下是几种解决方案：

方法1：在Dockerfile中安装字体

# 对于基于Debian/Ubuntu的镜像
RUN apt-get update && apt-get install -y \
    fonts-dejavu \
    fonts-liberation \
    fonts-noto \
    ttf-mscorefonts-installer \
    && rm -rf /var/lib/apt/lists/*

# 对于基于Alpine的镜像
RUN apk add --no-cache \
    fontconfig \
    msttcorefonts-installer \
    && update-ms-fonts \
    && fc-cache -f

方法2：手动添加特定字体文件

1. 将字体文件(.ttf/.otf)放入项目目录中的fonts/文件夹
2. 在Dockerfile中添加：

COPY fonts/ /usr/share/fonts/
RUN fc-cache -f -v

方法3：使用已包含字体的基础镜像

FROM python:3.9-slim  # 或其他包含字体的镜像

方法4：对于Java应用，指定字体目录

ENV JAVA_OPTS="-Djava.awt.headless=true -Djava.awt.fonts=/usr/share/fonts/"

验证字体安装

构建镜像后，可以进入容器验证：

docker run -it your-image bash
# 在容器内运行
fc-list  # 列出已安装字体

常见问题解决

1. 字体缓存问题：运行fc-cache -f刷新字体缓存
2. 权限问题：确保字体文件有正确权限(644)
3. 字体路径问题：检查应用是否在正确位置查找字体

特定应用解决方案

对于Python Matplotlib

RUN apt-get update && apt-get install -y \
    libfreetype6 \
    && rm -rf /var/lib/apt/lists/*

# 或者在Python代码中设置
import matplotlib
matplotlib.rcParams['font.family'] = 'DejaVu Sans'

对于Puppeteer/Headless Chrome

RUN apt-get update && apt-get install -y \
    fonts-liberation \
    fonts-noto-cjk \
    && rm -rf /var/lib/apt/lists/*

选择最适合您应用场景的方法，通常方法1或方法2是最常用的解决方案。