iOS端App退后台后出现Unrecognised font family错误如何解决？

• 先确认代码中引用的字体名称与字体实际的PostScript名称完全一致：在Mac的字体册中打开该字体，按Command + I查看详细信息，PostScript名称 字段才是iOS系统实际识别的唯一字体标识。很多非官方分发的字体会存在文件名、字体族展示名和PostScript名不匹配的问题，冷启动时的临时缓存可能兼容了名称匹配逻辑，后台系统回收资源后二次查找会严格匹配PostScript名，就会出现查找失败的问题。
• 检查字体注册逻辑的执行时机：如果你的字体注册逻辑没有放在didFinishLaunchingWithOptions中执行，或是使用第三方框架自动加载字体，可能存在App从后台恢复时注册逻辑未重新触发的情况。可以在applicationWillEnterForeground生命周期方法中遍历UIFont.familyNames输出所有已注册字体，确认该字体在后台恢复后是否还在注册列表中，若不存在可以添加手动注册逻辑，示例代码如下：

// Swift 手动注册字体示例
guard let fontPath = Bundle.main.path(forResource: "你的字体文件名", ofType: "ttf"),
      let fontData = try? Data(contentsOf: URL(fileURLWithPath: fontPath)),
      let dataProvider = CGDataProvider(data: fontData as CFData),
      let font = CGFont(dataProvider) else {
    print("字体文件读取失败")
    return
}
var error: Unmanaged<CFError>?
if !CTFontManagerRegisterGraphicsFont(font, &error) {
    print("字体注册失败: \(error?.takeRetainedValue().localizedDescription ?? "未知错误")")
}

• 验证字体文件本身的合法性：非官方渠道获取的字体可能存在格式损坏、权限标记错误的问题，你可以用Mac字体册的「验证文件」功能扫描该ttf文件，若存在格式错误可以用字体编辑工具重新导出一份符合标准格式的字体文件，导出时注意保留正确的PostScript名称、字体族等元数据属性。
• 确认文件配置的大小写完全匹配：iOS文件系统为大小写敏感，你需要核对Info.plist中Fonts provided by application项填写的字体文件名，和实际项目中的字体文件名大小写完全一致，部分场景下大小写不匹配会出现首次缓存加载正常、二次查找失败的偶现问题。
• 跨端框架额外排查方向：如果你使用React Native、Flutter等跨端框架，需要额外检查框架侧的字体缓存逻辑。跨端框架的样式层通常会缓存字体解析结果，后台恢复后原生层字体引用丢失但跨端层仍沿用旧的缓存标识，也会触发找不到字体的报错，这种情况可以在App从后台恢复时主动触发一次全局字体样式的重新注册。

内容的提问来源于stack exchange，提问作者Jiří Petera