Swift中使用Algolia InstantSearch包转换搜索结果为自定义对象问题

核心问题分析 #

你的代码主要存在两个关键问题：一是HitsInteractor的生命周期管理不当，二是未捕获解码过程中的错误，导致无法定位转换失败的原因。此外，自定义的解码初始化方法可能存在类型不匹配的隐患。

解决方案 #

1. 调整ViewModel结构，修复Interactor生命周期

将HitsInteractor从方法局部变量改为ViewModel属性，确保其生命周期与ViewModel一致，避免被提前回收：

private let searcher: HitsSearcher
private let hitsInteractor: HitsInteractor<Hit<SearchedUser>> // 提升为属性

init() {
    self.searcher = HitsSearcher(appID: "......", apiKey: "......", indexName: "users_info", isAutoSendingHitsViewEvents: true)
    self.hitsInteractor = HitsInteractor<Hit<SearchedUser>>()
    hitsInteractor.connectSearcher(searcher) // 初始化时一次性连接
}

func performSearch(query: String, completion: @escaping (Result<[SearchedUser], Error>) -> Void) {
    searcher.query = query
    
    // 移除旧订阅，避免重复触发
    hitsInteractor.onResultsUpdated.cancelSubscription(for: self)
    searcher.onError.cancelSubscription(for: self)
    
    hitsInteractor.onResultsUpdated.subscribe(with: self) { [weak self] _, _ in
        guard let self = self else { return }
        do {
            // 直接获取所有结果，自动处理解码
            let hits = try self.hitsInteractor.hits()
            let users = hits.map { $0.object }
            completion(.success(users))
        } catch {
            // 捕获解码错误并返回
            completion(.failure(error))
        }
    }

    searcher.onError.subscribe(with: self) { _, error in
        completion(.failure(error))
    }

    searcher.search()
}

2. 简化SearchedUser的Codable实现

移除不必要的自定义初始化方法，利用Codable自动实现解码，仅保留字段映射：

struct SearchedUser: Codable {
    var id: String { userId }

    var userId: String
    var name: String
    var username: String

    enum CodingKeys: String, CodingKey {
        case userId = "user_id"
        case name = "full_name"
        case username = "user_name"
    }

    // 删掉自定义init(from decoder:)，使用默认Codable实现
}

3. 处理类型不匹配场景（可选）

如果Algolia返回的user_id是数字类型而非字符串，需要在解码时做类型转换：

init(from decoder: Decoder) throws {
    let container = try decoder.container(keyedBy: CodingKeys.self)
    
    // 兼容数字/字符串两种类型的user_id
    if let userIdInt = try? container.decode(Int.self, forKey: .userId) {
        userId = String(userIdInt)
    } else {
        userId = try container.decode(String.self, forKey: .userId)
    }
    
    // 处理可选字段，避免因字段缺失抛出错误
    name = try container.decodeIfPresent(String.self, forKey: .name) ?? ""
    username = try container.decodeIfPresent(String.self, forKey: .username) ?? ""
}

关键验证步骤 #

1. 运行修改后的代码，若转换失败，completion会返回具体的解码错误（如字段缺失、类型不匹配），据此排查Algolia返回的JSON结构是否与SearchedUser定义一致。
2. 确认Algolia索引中的user_id、full_name、user_name字段类型与SearchedUser的属性类型完全匹配。

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