静态框架跨外部访问时关联对象键值不一致问题排查

这个问题确实和UnsafeRawPointer的生成逻辑以及Swift在静态框架下的符号可见性处理直接相关。

问题根源 #

当你把someProperty标记为public时，Swift编译器会为该属性的get/set方法生成公开符号。在静态框架场景下，其他模块引用这个公开属性时，由于AssociatedKeys是private访问级别，外部模块无法直接访问其内部的静态变量someKey——编译器会为每个引用该属性的模块单独生成一份AssociatedKeys.someKey的副本，导致&AssociatedKeys.someKey的内存地址在不同模块中不一致。而Objective-C关联对象是通过指针地址作为唯一标识的，地址不匹配自然无法读取到之前存储的值。

• 动态框架无此问题：因为动态框架的符号在运行时统一加载，所有模块共享同一份AssociatedKeys.someKey的内存地址。
• iOS 16模拟器修复：苹果优化了静态框架下公开符号对私有静态变量的引用逻辑，避免了多副本生成。
• 非public属性正常：此时编译器不会生成跨模块的公开符号，也就不会触发多副本问题。

解决方案 #

方案1：使用全局唯一的指针常量 #

定义一个全局的私有变量（无需结构体包裹），利用全局变量的内存地址唯一性确保跨模块访问时指向同一地址：

private var someAssociatedKey: UInt8 = 0

extension SomeClass {
  public var someProperty: String? {
    get { 
      return objc_getAssociatedObject(self, &someAssociatedKey) as? String
    }
    set {
      objc_setAssociatedObject(self, &someAssociatedKey, newValue, .OBJC_ASSOCIATION_RETAIN_NONATOMIC)
    }
  }
}

方案2：将关联键结构体改为public #

提升AssociatedKeys的访问级别为public，确保所有模块引用的是同一份静态变量：

public struct AssociatedKeys {
  public static let someKey = "someKey"
}

extension SomeClass {
  public var someProperty: String? {
    get { 
      return objc_getAssociatedObject(self, &AssociatedKeys.someKey) as? String
    }
    set {
      objc_setAssociatedObject(self, &AssociatedKeys.someKey, newValue, .OBJC_ASSOCIATION_RETAIN_NONATOMIC)
    }
  }
}

这里使用static let而非static var，避免键值被意外修改导致关联对象失效。

方案3：直接生成固定的UnsafeRawPointer #

通过哈希值生成固定的指针地址，确保跨模块访问时地址一致：

public let SomePropertyAssociatedKey = UnsafeRawPointer(bitPattern: "SomePropertyAssociatedKey".hashValue)!

extension SomeClass {
  public var someProperty: String? {
    get { 
      return objc_getAssociatedObject(self, SomePropertyAssociatedKey) as? String
    }
    set {
      objc_setAssociatedObject(self, SomePropertyAssociatedKey, newValue, .OBJC_ASSOCIATION_RETAIN_NONATOMIC)
    }
  }
}

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