如何使用SwiftLog包记录错误？解决类型转换报错问题

这个问题我帮不少开发者处理过，SwiftLog的Logger类对日志消息的类型有明确要求，咱们先搞清楚报错原因，再看几种解决方法，最后说最佳实践：

为什么会报错？ #

logger.error(_:)方法的第一个参数要求是Logger.Message类型，而不是原生的String或Error。SwiftLog设计这个类型是为了支持结构化日志、字符串插值优化等特性，所以直接传String或者Error实例都会触发类型不匹配的报错。

几种可行的解决方法 #

1. 显式将字符串转为Logger.Message #

如果只想记录错误的本地化描述，可以用Logger.Message的字符串字面量初始化器：

do {
    try something()
} catch {
    logger.error(Logger.Message(stringLiteral: error.localizedDescription))
}

2. 利用字符串插值自动转换 #

因为Logger.Message实现了ExpressibleByStringInterpolation协议，直接用字符串插值的方式传参，编译器会自动帮你转换成正确的类型，这是最简洁的写法之一：

do {
    try something()
} catch {
    logger.error("Operation failed: \(error.localizedDescription)")
    // 甚至直接传error的字符串表示也可以
    logger.error("Encountered error: \(error)")
}

3. 传入完整Error对象（推荐的最佳实践） #

SwiftLog的error方法提供了专门的重载，允许你传入原始的Error实例，这样日志会自动包含错误的类型、调用栈等上下文信息，对排查问题更有帮助：

do {
    try something()
} catch {
    // 自定义日志消息 + 传入原始Error
    logger.error("Failed to execute core operation", error: error)
}

这种方式的优势在于，日志系统不仅会记录你自定义的消息，还会附带错误的完整元数据，比如错误码、domain，甚至在开启详细日志时会包含调用栈轨迹，大大提升调试效率。

总结 #

如果只是简单记录错误描述，用字符串插值的写法最便捷；如果需要更完整的错误上下文用于调试排查，强烈推荐使用带error参数的重载方法，这也是SwiftLog官方推荐的最佳实践。

内容的提问来源于stack exchange，提问作者Wizard of Kneup