Moodle中TCPDF自定义字体无法正常显示问题求助

1. 验证字体转换与上传完整性 #

• 确认转换生成的.php、.z、.ctg.z三个文件全部完整上传至/lib/tcpdf/fonts/，同时将文件权限设置为Moodle进程可读取（建议设为644或755），避免因权限不足导致字体无法加载。
• 打开.php字体定义文件，检查$fontname变量值是否与Moodle下拉列表中显示的字体名称完全一致，同时确认字符集映射、字体属性等配置无错误。

2. 检查TCPDF字体注册与路径配置 #

• 进入服务器的/lib/tcpdf/目录，执行php utils/tcpdf_addfont.php工具，手动重新注册自定义字体，确保TCPDF能正确识别该字体。
• 打开config/tcpdf_config.php文件，确认K_PATH_FONTS常量指向的路径确实是/lib/tcpdf/fonts/，避免路径配置错误导致字体文件找不到。

3. 排查Moodle端字体调用逻辑 #

• 检查证书生成的代码，确认调用TCPDF的SetFont()方法时，传入的字体名称与字体定义文件中的$fontname完全匹配（TCPDF字体名称区分大小写），比如定义里是'custom_cert_font'，就不能写成'CustomCertFont'。
• 检查所用的证书生成插件是否存在字体过滤或强制替换的设置，部分插件可能会默认使用系统通用字体覆盖自定义选择。

4. 清除缓存 #

• 进入Moodle后台的「站点管理 > 开发 > 清除缓存」，清除站点缓存，确保Moodle加载最新的字体配置。
• 若TCPDF存在字体缓存文件，删除/lib/tcpdf/fonts/下的临时缓存文件，强制TCPDF重新加载字体。

5. 测试字体兼容性与独立验证 #

• 在/lib/tcpdf/目录下使用官方示例脚本（如examples/001.php），修改脚本中的SetFont()为你的自定义字体，运行脚本测试字体是否能正常渲染，排除Moodle插件层面的问题。
• 确认自定义字体支持你需要的字符集（如中文、特殊符号），若字体本身缺少对应字符，TCPDF会自动 fallback 到通用字体。

6. 调试日志定位问题 #

• 开启Moodle调试模式：进入「站点管理 > 开发 > 调试」，设置调试消息为「开发者级别」，查看生成PDF过程中是否有字体加载失败的错误提示。
• 查看服务器的PHP错误日志，排查是否存在文件读取失败、字体解析错误等相关报错，定位具体问题点。

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