谷歌浏览器在linux下中文字体渲染异常，首要原因是系统缺失中文字体（fc-list :lang=zh无输出），其次为chrome 140+与损坏字体（如heji2text.otf）冲突、simsun粗体映射失效及puppeteer未配置字体路径所致。
谷歌浏览器在Linux环境下无法正确渲染中文字体，是因为系统缺少预装的中文字体文件、Puppeteer启动参数未指定字体路径、网页CSS未配置中文字体回退链，以及Chrome 140版本引入的Fontations字体索引系统与某些损坏字体（如HEJI2Text.otf）发生冲突，导致文字显示为方块、模糊或完全空白。
验证系统是否缺失中文字体
打开终端，执行命令：fc-list :lang=zh。
若返回为空，说明系统未安装任何中文字体——【这是最常见且必须优先解决的前提】。
若返回结果中包含“Noto Sans CJK SC”“WenQuanYi Zen Hei”等字样，则字体已存在，问题可能出在渲染配置或冲突字体上。
卸载引发崩溃的异常字体文件
Chrome 140+ 在 Linux 上会因特定损坏字体触发渲染中断甚至崩溃。先检测是否存在高危字体：
运行命令：fc-list -f "%{file}\n" | grep -Ei 'unitwebrbw03medium.ttf|unitwebrbw03light.ttf|panton_black.otf|heji2text.otf'。
只要输出任意一行路径，就说明该字体已安装并正在干扰渲染——【必须立即删除对应.ttf或.otf文件，否则后续所有配置均无效】。
删除后执行 sudo fc-cache -fv 刷新字体缓存。
强制替换宋体粗体为可用字体
Linux 下 SimSun（宋体）本身不含粗体字重，Chrome 渲染 font-weight: bold 时会失真或发虚。需通过 fontconfig 规则硬性映射：
第一步：用 sudo 权限在 /etc/fonts/conf.d/ 目录下新建文件 s99-local.conf；
第二步：写入以下 XML 内容（注意第6、7、11、12行的 family 名称必须与开发者工具中实际捕获的一致）：
第三步：保存文件，执行 sudo fc-cache -fv 生效；
第四步：重启 Chrome 或整个系统——只有重启才能让 Chromium 进程加载新 fontconfig 规则。
修改 Puppeteer 启动参数（适用于 url-to-pdf-api 场景）
如果你使用的是基于 Puppeteer 的服务（例如 url-to-pdf-api），仅改系统字体不够，还需让 Chrome 实例主动识别字体路径：
编辑 src/core/render-core.js 文件，在 createBrowser(opts) 函数的 browserOpts 对象中添加：
args: ['--font-render-hinting=medium', '--disable-font-subpixel-positioning', '--font-cache-limit=1024']；
这三组参数分别控制字体提示精度、禁用亚像素定位（避免模糊）、扩大字体缓存上限（防止中文字体加载不全）。
若服务器部署了 Noto Sans CJK SC 字体，可追加：--font-path=/usr/share/fonts/truetype/noto 显式声明路径。
