HarfBuzz项目中的CJK大字体WOFF2格式解析问题分析

背景介绍

在Web开发中使用CJK(中日韩)字体时，开发者经常会遇到字体文件过大的问题。近期有开发者报告在使用BabelStoneHan这款包含超过6万个字形的大型CJK字体时，WOFF2格式的字体文件在主流浏览器中无法正常加载，而WOFF格式则工作正常。

问题现象

当开发者尝试通过@font-face规则加载WOFF2格式的BabelStoneHan字体时，不同浏览器表现出以下错误：

1. Firefox显示"downloadable font: rejected by sanitizer"错误
2. Chrome显示"Failed to decode downloaded font"和"OTS parsing error: Failed to convert WOFF 2.0 font to SFNT"错误
3. Safari无错误提示但字体不工作
4. 有趣的是，在iPadOS上该字体却能正常工作

技术分析

经过深入调查，发现该问题涉及多个技术层面的因素：

WOFF2解码器限制

问题的核心在于WOFF2解码器的默认输出缓冲区大小限制。Google的WOFF2库默认设置了30MB的解码输出限制，而BabelStoneHan字体解压后实际大小约为51MB，远超此限制。

字体元数据不一致

进一步分析发现，FontCreator生成的WOFF2文件中，totalSfntSize字段(声明解压后字体大小)设置不正确：

• 文件头声明为51281916字节
• 实际解压后为51380272字节

这种元数据与实际数据的不匹配导致浏览器解码失败。

浏览器实现差异

不同浏览器对这种情况的处理方式不同：

1. Firefox已提交补丁放宽限制并处理元数据不准确的情况
2. Chrome将限制提高到128MB，但仍可能受内部WOFF2StringOut的30MB限制影响
3. Safari的行为表明其可能采用了更严格的验证机制

解决方案

对于开发者而言，可以采取以下措施：

1. 联系字体工具开发商：报告FontCreator中WOFF2生成工具的元数据设置问题
2. 使用替代工具生成WOFF2：如经测试确认某些在线转换工具能生成正确的WOFF2文件
3. 暂时使用WOFF格式：作为兼容性更好的临时解决方案
4. 关注浏览器更新：特别是Firefox即将发布的修复版本

技术启示

这一案例揭示了几个重要的技术要点：

1. 大字体处理：CJK字体通常体积庞大，开发工具链需要特别考虑这一特性
2. 格式验证：WOFF2等现代字体格式的严格验证机制可能成为双刃剑
3. 浏览器兼容性：不同浏览器对标准的实现细节可能导致显著的行为差异

结论

大型CJK字体的Web应用仍面临技术挑战，需要字体工具、格式规范和浏览器实现的协同改进。开发者在使用这类字体时应充分测试各平台兼容性，并关注相关工具和浏览器的更新进展。随着WOFF2格式的普及和相关工具的完善，这类问题有望得到更好的解决。