使用mPDF输出时字符重叠侵入单元格问题咨询

算力阿峰

2026-5-15

解决mPDF输出时特定字符串字符重叠侵入单元格的问题

这种仅特定字符串触发的渲染异常，大概率和字符的字形特性或者mPDF的字符宽度计算逻辑有关，下面是几个常见原因和对应的排查/解决方向：

字体的字形宽度异常
有些字体对特定字符（比如生僻字、特殊组合字符）的宽度定义和常规字符不一致，mPDF在计算单元格宽度时，会用预设的字符平均宽度或者单个字符的标称宽度来计算，但如果这个字符实际渲染的宽度和计算值不符，就会出现溢出重叠。你可以尝试换用更标准的字体（比如Noto Sans系列），或者给问题字符串单独指定字体测试：
```
// 给特定字符串指定标准字体
$mpdf->WriteHTML('<span style="font-family: Noto Sans SC;">你的问题字符串</span>');
```
特殊字符/隐式控制字符混入
有时候问题字符串看起来和正常字符串字符数相同，但可能包含了看不见的控制字符（比如零宽空格、软连字符）或者编码异常的字符，这些字符会干扰mPDF的宽度计算。可以先把问题字符串复制到纯文本编辑器（比如Notepad++）开启显示所有字符模式检查；也可以用代码清理异常字符：
```
// 清理不可见控制字符
$cleanStr = preg_replace('/[\x00-\x1F\x7F]/u', '', $problemStr);
```
mPDF的字符宽度缓存bug
mPDF会缓存已渲染字符的宽度信息，偶尔会出现缓存异常导致特定字符宽度计算错误的情况。你可以尝试在输出问题字符串前强制刷新字体缓存，或者直接升级到最新版本的mPDF（新版本通常会修复这类渲染bug）：
```
// 强制刷新字体缓存（适用于mPDF 7+版本）
$mpdf->fontdata = [];
$mpdf->SetFont('你当前使用的字体');
```
单元格宽度自适应逻辑问题
如果是表格单元格的问题，可能mPDF在计算单元格最小宽度时，没有正确识别特定字符串的实际宽度。可以尝试手动指定单元格宽度，或者开启mPDF的表格自适应配置：
```
// 开启表格自动收缩适配
$mpdf->shrink_tables_to_fit = 1;
```