使用node-poppler转PDF为JPEG时Adobe PiStd复选框无勾选标记问题

问题背景 #

使用node-poppler 23.05.0-r0将PDF转换为JPEG时，发现由Adobe InDesign 18.1创建的PDF里，用Adobe PiStd字体制作的复选框勾选标记转换后变为空白。已尝试安装多种字体（手动安装AdobePiStd.otf），但问题未解决，且检查文档属性未发现对AdobePiStd字体的引用。

Docker环境中字体安装配置如下：

RUN apk add --no-cache "poppler>${POPPLER_VERSION}" "poppler-utils>${POPPLER_VERSION}" "poppler-glib>${POPPLER_VERSION}" \
            --repository=https://dl-cdn.alpinelinux.org/alpine/v3.17/main/ \
            --repository=https://dl-cdn.alpinelinux.org/alpine/edge/main/
RUN apk add --no-cache  pdfgrep fontconfig freetype ttf-liberation
RUN fc-cache -f

RUN apk --update add font-freefont fontconfig msttcorefonts-installer ghostscript-fonts && \
update-ms-fonts && \
fc-cache -f -v

WORKDIR '/tmp'
COPY AdobePiStd.otf /tmp/AdobePiStd.otf
RUN cp -r /tmp/AdobePiStd.otf /usr/share/fonts/freefont/AdobePiStd.otf
RUN fc-cache -f -v

可能的解决方向 #

1. 确认字体是否被系统正确识别 #

手动复制字体后，poppler可能未正确加载。执行以下命令检查字体是否在fontconfig的识别列表中：

fc-list | grep -i "AdobePiStd"

如果无输出，说明字体未被识别。可尝试将字体移至标准字体目录（如/usr/share/fonts/truetype/，不存在则先创建），再重新执行fc-cache -f -v更新字体缓存。

2. 用poppler原生工具排除封装层问题 #

node-poppler是对poppler工具的封装，先用pdftocairo直接测试转换，确认问题是否出在poppler本身：

pdftocairo -jpeg input.pdf output.jpg

若转换后仍空白，说明是poppler对该PDF表单外观的处理问题。可尝试：

• 更新poppler至最新稳定版（当前使用23.05，可尝试24.x版本）
• 换用pdftoppm工具测试：pdftoppm -jpeg input.pdf output

3. 配置fontconfig强制字体替代 #

部分PDF会使用子集化字体或隐藏字体引用，即使文档属性看不到，渲染仍依赖目标字体。可创建/etc/fonts/local.conf配置替代规则：

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
  <match target="pattern">
    <test name="family"><string>AdobePiStd</string></test>
    <edit name="family" mode="assign"><string>Arial</string></edit>
  </match>
</fontconfig>

执行fc-cache -f更新缓存后，再尝试转换。

4. 检查InDesign的PDF导出设置 #

InDesign导出PDF时的字体嵌入设置可能导致poppler无法识别：

• 导出时在「输出」选项卡中，将「嵌入字体」设为「全部嵌入」
• 取消勾选「子集化嵌入字体」选项
• 确保表单字段的外观设置为「嵌入外观」

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