TCPDF自定义字体部署异常：本地正常Linux服务器生成文档空白

以下是针对该问题的具体排查方向：

• 文件权限检查
  Linux系统对文件权限要求比Windows严格，需确认转换后的字体相关文件（包括.php、.z等TCPDF生成的文件）及所在目录，是否允许Web服务器进程（如www-data、apache）读取。可执行chmod 644 [字体文件]给文件设置可读权限，目录用chmod 755 [字体目录]确保可访问；同时检查文件/目录的所有者是否与Web服务器进程匹配。

• 路径大小写校验
  Windows文件名不区分大小写，但Linux严格区分。要确保代码中调用addFont()时传入的字体名称，和服务器上的字体文件/目录名完全一致，包括大小写。比如本地写的"MyCustomFont"，服务器上如果是"mycustomfont"就会导致加载失败。

• 字体转换文件完整性
  对比本地和服务器上的字体转换产物，确保add_font工具生成的所有文件都完整上传到了服务器，包括字体定义.php、压缩字体数据.z、.ctg.z等辅助文件。更稳妥的方式是直接在Linux服务器上重新用add_font工具转换一次字体，避免跨系统转换带来的兼容性问题。

• TCPDF字体路径配置验证
  检查TCPDF中K_PATH_FONTS常量的配置，确认其指向的字体目录在服务器上是正确的。可以在代码中临时输出该常量的值（比如echo K_PATH_FONTS;），验证路径是否和实际字体存放路径一致。另外，若存在字体缓存，尝试清理缓存文件，避免旧数据干扰。

• 字体编码与系统兼容性
  部分TrueType Unicode字体可能包含Windows特定元数据，在Linux下解析异常。可以用fc-list命令（需先安装fontconfig工具）检查服务器是否能识别该字体；同时在调用addFont()时明确指定编码参数，比如$pdf->addFont('MyFont', '', 'MyFont.php', true, 'UTF-8');，确保TCPDF以正确编码加载字体。

• 开启调试模式排查隐藏错误
  虽然目前无报错提示，但可以手动开启调试：

  1. 在代码开头添加error_reporting(E_ALL); ini_set('display_errors', 1);，开启PHP全量错误输出
  2. 初始化TCPDF时设置$pdf->setDebug(true);，查看TCPDF内部的调试信息，可能会发现隐藏的加载失败原因

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