如何解决调用Firebase HTTPS Callable函数时GeoPoint类型不支持的问题？

iOS 端 Firebase Functions SDK 的参数发送流程包含本地类型校验环节，仅允许传入可完成JSON序列化的基础类型（字符串、数字、布尔值、字典、数组、空值）。原生 SDK 提供的GeoPoint（对应OC层的FIRGeoPoint）是Firestore模块专用的特殊类型，未被纳入云函数调用链路的序列化白名单，只要参数树中存在这类实例，就会触发"Unsupported type: FIRGeoPoint"的报错，此时请求还未进入网络传输环节。

• 调整GeoPoint的编码输出格式：放弃默认将原生GeoPoint实例直接放入参数字典的逻辑，将所有GeoPoint对象转换为纯数值结构的字典，格式为包含latitude、longitude两个数字字段的嵌套字典，这个结构是完全可JSON序列化的，能通过本地校验。
• 基于当前使用的编码工具扩展自定义编码分支：当前编码工具默认对GeoPoint的处理逻辑是直接保留原生类型实例，这就是触发本地校验报错的直接原因。我们可以在编码流程中专门拦截GeoPoint类型的编码操作，直接输出上述经纬度字典，不要把原生GeoPoint实例透传到最终的调用参数里。可参考的适配逻辑：

  // 在自定义类型的encode实现中，对GeoPoint字段做单独处理
  func encode(to encoder: Encoder) throws {
      var container = encoder.container(keyedBy: CodingKeys.self)
      // 对GeoPoint字段，不使用默认编码逻辑，手动取出经纬度存入字典
      try container.encode(
          [
              "latitude": targetGeoPoint.latitude,
              "longitude": targetGeoPoint.longitude
          ],
          forKey: .targetGeoPoint
      )
  }
  

• 兜底参数全量校验：在把编码后的对象传给call方法前，递归遍历整个参数字典树，检查是否存在残留的原生GeoPoint实例，尤其是嵌套字典、数组元素里的隐藏GeoPoint，发现后统一替换为经纬度字典结构，再发起调用。

• 转换时经纬度字段需保留数值类型，不要转成字符串，否则即使请求成功发出，后续服务端处理时也会出现类型不匹配问题
• 不需要修改Firebase SDK的内部类型校验逻辑，这类侵入性修改在后续SDK版本升级时极易出现兼容异常
• 云函数端接收参数后，可直接从返回的字典中读取经纬度值构造业务需要的GeoPoint对象，无需额外适配格式

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