iOS极光推送别名限制问题

我们的项目中集成了极光推送，将用户id设置为别名，方便服务端对某个用户发送自定义消息。前几天遇到了一个用户反应无法收到推送，经过调试发现在设置别名时返回了错误码6009，极光官网的说明如下：

SDK 发生了意料之外的异常，客户端日志中将有详细的报错信息，可据此排查。

然后设置为debug模式，依然不知道是什么原因。于是先想到的就是升级一下SDK。升到最新版3.4.0之后，错误码变成了6017。错误原因如下：

本次请求出现异常参数，请求无效；
2020/03/10 日新增：别名绑定的设备数超过限制，最高允许绑定 10 个，更多请联系商务

然后在极光官方文档上发现了这样一句话：

温馨提示：
iOS 9 系统，应用卸载重装，APNs 返回的 devicetoken 会发生变化，
开发者需要获取设备最新的 Registration id。
请在 kJPFNetworkDidLoginNotification 的实现方法里面调用 "RegistrationID" 这个接口来获取 RegistrationID。

RegistrationID就算作一个设备，即使我们是同一个手机，在卸载重装之后如果RegistrationID发生变化，就会算作一个新的设备，当重复卸载重装就会出现别名绑定失败，导致接收不到推送。
什么情况下RegistrationID会发生变化

然后我就尝试卸载重装，发现RegistrationID并未发生变化，这就很奇怪了。又是一通查找，找到了这篇文章
里面有提到极光内部的一些处理，极光会将数据保存到粘贴板，如果重装时发现粘贴板有数据，RegistrationID就跟上次一样，如果没有数据，就会生成新的RegistrationID。
然后尝试卸载APP后关机重启，再安装。RegistrationID果然发生了变化。

到现在知道了收不到推送的原因了，极光官方提倡我们去充钱，能将设备上限提升到100个。但是无法从根本上解决问题，所以继续寻找解决方案。

在极光服务端的API文档中找到了这一部分

获取指定别名下的设备，最多输出 10 个
GET /v3/aliases/{alias_value}

批量解绑设备与别名之间的关系。
POST /v3/aliases/{alias_value}

我们可以在客户端通过调用极光服务端的API，解除别名绑定的设备。

具体解决思路如下：

1、设置别名报错6009、6017、6027时查询别名绑定的设备数
2、如果绑定的设备数大于等于10，则批量解除绑定
3、解除绑定后重新设置别名

1、查询别名的设备数

let urlString = String(format: "https://device.jpush.cn/v3/aliases/%@?platform=ios", alias)
var request = URLRequest(url: URL(string: urlString)!, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 30)
request.setValue(getJPushBase64AuthString(), forHTTPHeaderField: "Authorization")
let session = URLSession.shared
let dataTask = session.dataTask(with: request) { (data, response, error) in
        // 这里解析数据，会返回指定别名绑定的所有RegistrationID(最多10个)
        // 如果设备数大于等于10，则进行删除操作
}
dataTask.resume()

// 极光base64_auth_string
// JPushAppKey和JPushSecret可以在极光后台看到
func getJPushBase64AuthString() -> String {
    let authString = JPushAppKey + ":" + JPushSecret
    let authData = authString.data(using: String.Encoding.utf8)
    let base64String = authData?.base64EncodedString(options: NSData.Base64EncodingOptions.init(rawValue: 0))
    return "Basic \(base64String ?? "")"
}

2、批量解除绑定

let urlString = String(format: "https://device.jpush.cn/v3/aliases/%@", alias)
var request = URLRequest(url: URL(string: urlString)!, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 30)
request.setValue(getJPushBase64AuthString(), forHTTPHeaderField: "Authorization")
request.httpMethod = "POST"
request.httpBody = deleteModel.toJSONString()?.data(using: .utf8)
// httpBody 格式如下：
// {
//   "registration_ids":{"remove": ["registration_id1", "registration_id2"]}
// }
let session = URLSession.shared
let dataTask = session.dataTask(with: request) { (data, response, error) in
    if error == nil {
        // 在这里重新设置别名
    }
}
dataTask.resume()

极光在2020/03/10对别名绑定的设备数做了限制，在之前接入极光SDK的APP，使用别名功能时应该都存在这个问题的隐患，在此记录一下。
不得不吐槽一下极光的文档，对于设备也就是RegistrationID是否发生变化说的并不准确，而且iOS的SDK里并未提供批量解除别名绑定的API。
至于这个API到底是由客户端去调用还是服务端去调用，就仁者见仁智者见智了。