Realm Swift 中 CustomPersistable 协议在 Xcode 16 下的兼容性问题解析

问题背景

在 iOS 开发中使用 Realm Swift 数据库时，开发者经常会通过实现 CustomPersistable 协议来扩展原生类型（如 CGPoint、CGRect 等）的持久化能力。然而，随着 Xcode 16 和 Swift 6 的发布，这种实现方式在 iOS 17 及以下版本设备上出现了兼容性问题。

问题现象

当开发者使用 Xcode 16 编译项目，并在 iOS 17 或更低版本的设备上运行时，应用会在访问 CustomPersistable 类型时崩溃。错误信息表明：

Conformance of 'CGPoint' to 'Hashable' is only available in iOS 18.0 or newer; this is an error in the Swift 6 language mode

崩溃发生在尝试获取类型信息时，特别是在 PersistedProperty.swift 文件的第 371 行附近。

技术分析

根本原因

这个问题源于 Swift 6 语言模式对协议一致性要求的严格性增强。在 iOS 18 之前，Core Graphics 类型（如 CGPoint、CGRect 等）并未正式实现 Hashable 协议。而在 Swift 6 下，CustomPersistable 的实现隐式要求了 Hashable 协议的支持。

深层机制

Realm Swift 在内部使用类型信息来管理数据库模式。当它尝试获取一个类型的 _rlmType 时，会检查该类型是否符合各种协议。在 Swift 6 下，这种检查更加严格，会验证所有相关协议的一致性是否可用。

解决方案

临时解决方案

对于需要支持 iOS 17 及以下版本的项目，可以采用以下方法：

1. 为 Core Graphics 类型手动实现 Hashable：

@available(iOS, obsoleted: 18)
extension CGPoint: @retroactive Hashable {
    public func hash(into hasher: inout Hasher) {
        hasher.combine(x)
        hasher.combine(y)
    }
}

2. 降级到 Xcode 15：如果项目不急需 Swift 6 特性，可以暂时使用 Xcode 15 进行开发。

长期解决方案

1. 等待 Realm 官方更新：Realm 团队可能会发布针对 Swift 6 的兼容性更新。

2. 升级最低部署目标：如果项目可以接受，将最低部署目标提高到 iOS 18。

最佳实践建议

1. 类型安全包装：考虑为 Core Graphics 类型创建专门的 Realm 模型对象，而不是直接扩展原生类型。

public class RealmPoint: EmbeddedObject {
    @Persisted var x: Double
    @Persisted var y: Double
    
    convenience init(_ point: CGPoint) {
        self.init()
        self.x = point.x
        self.y = point.y
    }
    
    var cgPoint: CGPoint {
        return CGPoint(x: x, y: y)
    }
}

2. 版本检查：在代码中添加运行时版本检查，确保在不同系统版本上有适当的行为。

3. 单元测试覆盖：确保对自定义持久化类型的测试覆盖了所有支持的 iOS 版本。

总结

Xcode 16 和 Swift 6 带来了更严格的类型安全检查，这虽然提高了代码安全性，但也带来了一些兼容性挑战。对于使用 Realm Swift 的开发者来说，理解这些变化并采取适当的应对措施至关重要。通过合理的架构设计和版本适配策略，可以确保应用在各种环境下稳定运行。