Dompdf设置UTF-8编码后文档内容仍显示异常该如何处理？

1. 字体加载有效性检查 #

• 确认Dompdf安装包携带完整DejaVu字体文件，默认存放路径为dompdf/lib/fonts，精简安装可能缺失该字体，可替换为完整Dompdf安装包，或手动下载DejaVu字体放入对应目录
• 检查字体目录读写权限，确保Dompdf进程可正常读取字体文件

2. CSS字体规则调整 #

• 弃用通配符*设置字体，避免优先级被覆盖，显式给根标签指定字体：

<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<style>
html, body {
  font-family: DejaVu Sans, sans-serif;
  font-size: 12px;
}
</style>

• 排查HTML内联样式、内部样式是否指定了未导入的其他字体（如Arial、宋体等），未导入的字体会触发 fallback 逻辑导致字符渲染异常

3. PHP 编码逻辑优化 #

• 移除mb_convert_encoding($content, 'HTML-ENTITIES', 'UTF-8')代码行，多数场景下原始内容已经为UTF-8编码，重复转码反而会导致字符乱码，直接显式指定编码加载HTML即可：

$dompdf->loadHtml($content, 'UTF-8');

• 提前校验$content本身编码是否为UTF-8，可通过mb_detect_encoding($content, ['UTF-8', 'GBK', 'GB2312'])检测，若原始编码非UTF-8，先转码为UTF-8再加载

4. Dompdf 核心配置校验 #

• 初始化时显式开启UTF-8相关配置：

use Dompdf\Dompdf;
use Dompdf\Options;

$options = new Options();
$options->set('isHtml5ParserEnabled', true);
$options->set('defaultFont', 'DejaVu Sans');
$dompdf = new Dompdf($options);

• 确认Dompdf版本≥0.8.0，旧版本存在大量UTF-8支持bug，建议升级到最新稳定版

5. 特殊字符兼容处理 #

如果内容包含生僻汉字、emoji或小众特殊符号，DejaVu Sans字体未覆盖该类字符，可手动导入支持对应字符的字体（如思源黑体、微软雅黑）到Dompdf字体目录，在CSS中指定该字体即可正常渲染。 #

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