iOS 17自定义字体显示为Helvetica且无法使用的排查咨询

应用通过按需资源下载并注册自定义字体至系统，iOS 16及之前版本运行正常，但iOS 17出现偶发问题：UIFontPickerViewController中字体名称错误显示为"Helvetica"、选中字体无法渲染，或字体突然消失，且已确认字体已正确安装至系统。以下是针对性排查步骤：

一、字体注册流程的异步一致性检查 #

• 排查CTFontManagerRegisterFontURLs回调逻辑：当前代码在success为true但存在errors时，误判为注册失败。iOS 17对字体注册的错误处理逻辑可能调整，部分场景下的警告不影响字体可用性。建议打印errors具体内容，区分严重错误与非阻塞警告。
• 注册完成后触发系统字体更新：添加CTFontManagerPostFontsChangedNotification()调用，确保系统字体库同步最新注册的字体，避免UIFontPickerViewController读取旧缓存。

二、按需资源的生命周期管理 #

• 确保NSBundleResourceRequest实例被持有：requestFont方法返回的请求实例若被提前释放，iOS 17可能回收资源访问权限。需在字体使用周期内保持该实例的强引用。
• 验证字体URL有效性：注册前检查文件路径是否存在，避免因按需资源路径失效导致注册异常：

let urls = font.fonts.compactMap { $0.fontURL }.filter { FileManager.default.fileExists(atPath: $0.path) }
guard !urls.isEmpty else {
    completion(nil, false)
    return
}

三、UIFontPickerViewController同步逻辑优化 #

• 延迟展示选择器：iOS 17中字体库更新通知可能存在延迟，注册完成后不要立即弹出UIFontPickerViewController，可监听CTFontManagerFontsChangedNotification通知，或等待1-2秒后再展示，确保选择器获取最新字体列表。
• 校验字体元数据：注册后通过CTFontManagerCopyAvailableFontFamilyNames()获取系统已注册字体，对比自定义字体的PostScript名称是否存在，避免因名称匹配失败导致显示为Helvetica。

四、系统级特殊场景排查 #

• 测试前台注册流程：iOS 17对后台操作限制更严格，若应用在后台完成字体注册，可能导致系统未同步。尝试将注册操作放到前台执行，或申请后台任务权限延长操作时间。
• 排查字体缓存冲突：重启设备后测试问题是否消失，同时检查是否有其他应用注册同名字体导致冲突。

代码优化建议 #

调整注册方法的错误处理逻辑，确保准确判断注册结果并触发系统更新：

func registerFont(_ font : Font, completion:@escaping((CFArray?, Bool)->())) {
    let urls = font.fonts.compactMap { $0.fontURL }.filter { FileManager.default.fileExists(atPath: $0.path) }
    guard !urls.isEmpty else {
        completion(nil, false)
        return
    }
    
    CTFontManagerRegisterFontURLs(urls as CFArray, .persistent, true) { errors, success in
        if let errs = errors {
            Log.debug("Font registration details: \(errs.debugDescription)")
        }
        // 以success作为注册成功的判断标准，错误仅用于日志排查
        completion(errors, success)
        // 通知系统更新字体库
        CTFontManagerPostFontsChangedNotification()
        return success
    }
}

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