如何在保留Apple结构化日志优势的同时实现持久化日志？

Apple自2020年WWDC起推广OSLog框架的Logger组件（例如2023年WWDC的10226场次《Debug with structured logging》），它具备高效特性，但存在局限：iOS应用仅能通过.currentProcessIdentifier读取自身进程的日志条目，应用崩溃后无法查看崩溃前的日志。为实现崩溃时的日志提交需求，需同时将日志写入带轮转功能的文件，但直接封装Logger时会遇到编译错误——OSLogMessage依赖编译期特殊特性，无法直接封装传递。

以下是三种可行的解决方案，均能保留OSLog结构化日志的核心优势：

方案1：利用Swift结果构建器模拟OSLog插值语法 #

自定义日志消息构建器，在编译期处理隐私标记，同时生成符合OSLog要求的消息和可持久化的结构化数据：

import OSLog

// 自定义持久化日志条目结构
struct PersistentLogEntry {
    let level: OSLogType
    let message: String
    let metadata: [String: Any]
    let timestamp: Date
}

struct HybridLogger {
    static let shared = HybridLogger()
    private let osLogger = Logger(subsystem: "com.your.app", category: "main")
    private let fileLogger = FileRotatingLogger() // 自定义的文件轮转日志器

    // 定义结果构建器处理日志插值逻辑
    @resultBuilder
    struct LogMessageBuilder {
        static func buildExpression(_ value: String) -> (osMessage: OSLogMessage, persistentMessage: String) {
            (OSLogMessage(stringLiteral: value), value)
        }
        
        static func buildExpression<T>(_ value: (value: T, privacy: OSLogPrivacy)) -> (osMessage: OSLogMessage, persistentMessage: String) {
            let osMsg = OSLogMessage(stringLiteral: "\(value.value, privacy: value.privacy)")
            let persistentMsg = "\(value.value)"
            return (osMsg, persistentMsg)
        }
        
        static func buildBlock(_ components: (osMessage: OSLogMessage, persistentMessage: String)...) -> (osMessage: OSLogMessage, persistentMessage: String) {
            let osMsg = components.reduce(OSLogMessage(stringLiteral: "")) { $0 + $1.osMessage }
            let persistentMsg = components.map { $1.persistentMessage }.joined()
            return (osMsg, persistentMsg)
        }
    }

    func error(@LogMessageBuilder message: () -> (osMessage: OSLogMessage, persistentMessage: String)) {
        let (osMsg, persistentMsg) = message()
        osLogger.error(osMsg)
        let entry = PersistentLogEntry(level: .error, message: persistentMsg, metadata: [:], timestamp: Date())
        fileLogger.write(entry)
    }
}

// 使用方式
HybridLogger.shared.error {
    "Configuration failed: " + (res, privacy: .public)
}

方案2：通过OSLog订阅API捕获日志（iOS 15+/macOS 12+） #

从iOS 15开始，OSLog提供OSLogSubscription API，可订阅当前进程的日志流，直接获取系统生成的结构化日志条目并持久化，完全保留OSLog原生特性：

import OSLog

class LogPersistenceManager {
    private let fileLogger = FileRotatingLogger()
    private var subscription: OSLogSubscription?

    init() {
        guard let logStore = try? OSLogStore(scope: .currentProcessIdentifier) else { return }
        let position = logStore.position(date: Date()) // 从当前时间开始订阅日志
        subscription = try? logStore.subscribe(to: [], at: position) { [weak self] entry in
            guard let self = self, let entry = entry as? OSLogEntryLog else { return }
            // 将系统日志条目转换为自定义持久化格式
            let persistentEntry = PersistentLogEntry(
                level: entry.type,
                message: entry.composedMessage,
                metadata: entry.metadata ?? [:],
                timestamp: entry.date
            )
            self.fileLogger.write(persistentEntry)
        }
    }
}

// App启动时初始化
let logPersistenceManager = LogPersistenceManager()

注意：该API在后台进程中存在一定限制，需确保订阅持续活跃。

方案3：封装泛型方法利用Swift隐式转换 #

为HybridLogger定义泛型方法，借助Swift的自动类型推导，直接接收带隐私标记的插值参数，同时传递给OSLogger和文件日志器：

import OSLog

protocol OSLogMessageConvertible {}
extension String: OSLogMessageConvertible {}
extension OSLogMessage: OSLogMessageConvertible {}

struct HybridLogger {
    static let shared = HybridLogger()
    private let osLogger = Logger(subsystem: "com.your.app", category: "main")
    private let fileLogger = FileRotatingLogger()

    func error<T>(_ message: T) where T: OSLogMessageConvertible {
        guard let osMsg = message as? OSLogMessage else { return }
        osLogger.error(osMsg)
        // 提取结构化日志内容用于持久化
        let persistentMsg = osMsg.description
        fileLogger.log(level: .error, persistentMsg)
    }
}

// 使用方式与原生Logger完全一致
HybridLogger.shared.error("Configuration failed: \(res, privacy: .public)")

该方案依赖Swift隐式转换特性，需注意类型安全，避免运行时错误。

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