如何便捷转换RealmSwift调用Atlas函数的返回AnyBSON为Swift对象

问题概述 #

调用MongoDB Atlas函数后，返回RealmSwift.AnyBSON格式的复杂文档（含大量键值对与嵌套结构），手动逐个键解析效率极低；尝试使用BSONSerialization时出现“Cannot find 'BSONSerialization' in scope”错误，需要高效的解析方案。

两种可行解决方案 #

方案1：基于Codable自动解码（推荐） #

RealmSwift的AnyBSON兼容MongoDB的BSON规范，结合MongoSwiftBSON库的BSONDecoder可实现一键转Swift对象，步骤如下：

1. 导入必要模块
   确保项目中引入MongoSwiftBSON（RealmSwift通常间接依赖，若未自动导入，需手动添加到依赖管理工具）：

import RealmSwift
import MongoSwiftBSON

2. 定义匹配结构的Codable模型
   根据Atlas函数返回的BSON结构，定义对应的Swift结构体：

struct FunctionResponse: Codable {
    let status: Int32
    let request: RequestDetails
    
    struct RequestDetails: Codable {
        let _last: Bool
        let upgradeOrConnect: Bool
        // 按实际返回字段补充其他属性
    }
    // 补充其他顶层字段
}

3. 执行解码
   将返回的AnyBSON转为BSONDocument后解码：

// result为Atlas函数调用返回值
guard let bsonDoc = result as? BSONDocument else {
    // 处理类型转换失败
    return
}

do {
    let decoder = BSONDecoder()
    let response = try decoder.decode(FunctionResponse.self, from: bsonDoc)
    // 直接使用response的属性，如response.status、response.request._last
} catch {
    print("解码失败：\(error.localizedDescription)")
}

方案2：动态访问AnyBSON属性（无需定义模型） #

若不想编写Codable模型，可利用AnyBSON的下标与类型属性直接取值，避免繁琐的类型判断：

guard let bson = result as? AnyBSON else { return }

// 直接获取顶层字段值
let status = bson["status"]?.int32Value
// 访问嵌套字段
let isLastRequest = bson["request"]?["_last"]?.boolValue
let isUpgradeAction = bson["request"]?["upgradeOrConnect"]?.boolValue

AnyBSON提供了int32Value、boolValue、stringValue等属性，会自动尝试转换类型，失败则返回nil。

关于BSONSerialization的说明 #

BSONSerialization属于旧版MongoDB Swift驱动API，新版已废弃，若需将BSON转为Data，可直接调用BSONDocument的toData()方法：

let bsonData = try bsonDoc.toData()

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