2019 年 2 月常见问题
1.【存储】怎么存储和获取音频/视频文件的时长 ？
AV.File 的 metaData 属性，可以用来保存和获取该文件对象的元数据信息。可以在上传音频文件时获取音频长度然后通过 metaData 方法手动添加文件时长。
2.【即时通信】对话查询如何区分单聊还是群聊？
SDK 层面不区分单聊和群聊。可以使用会话的成员数量做区分。「会话成员数量为 2」即是单聊，大于 2 即可看作群聊。
3.【即时通信】语音消息如何标记消息是否已经播放，类似微信语音消息标记是否已读的小红点，可以提供一些思路吗？
因为一个群里可能有很多人，每个人对一条消息都有一个「是否已播放」的状态，所以建议在客户端维护这个「未播放」状态。
做法之一是可以在客户端维护一个「收到了但是没有播放的音频文件」列表，然后拿到消息文件对比一下客户端是否已经播放过。
4.【即时通信】使用 where 查询条件查询某用户的会话列表，为什么查询结果是系统内所有用户的会话？
当没有添加任何 where 查询条件时，query 会使用默认查询条件 where={"m":{"$in":["client ID"]}}，即查询成员含有此 client ID 的对话；当添加了任意 where 查询条件时，query 会严格按 where 条件来查询，即覆盖默认的 where 查询条件。
以 Objective - C 举例，添加了自定义的 where 查询条件时，如果想查询含有此 client ID 的对话，使用 [query whereKey:@"m" containedIn:@[@"client ID"]] 增加一个查询条件即可。
2019 年 1 月常见问题
1. 【存储】数据存储表的字段是否有数量上限？字段多对性能是否有影响？
我们的存储功能基于 MongoDB，属于文档型数据库，这里的文档类似于 JSON 这样的非结构化数据，与传统的关系型数据库不一样， 所以讨论字段（关系型数据库中称为列）多少是没有意义的。
一个文档大小有 16 M 的限制，但是开发者真正使用时应远小于这个值，保证在几百 KB 之内能有较好的插入、查询、更新速度。
因为字段名是存在每个文档中的，所以字段名越短越节约空间。
2.【即时通信】安卓客户端怎么获取对话免打扰状态？
对于 Android 来说，不存在免打扰状态的。消息静音是针对 iOS 设备而言的（指不发送离线消息）。
Android 没有离线通知，因为聊天和推送使用的是同一个 WebSocket 长链接，聊天那里不在线，推送也是过不去的。
3. 【控制台】控制台的应用为什么会被归档，被归档的应用怎么重新激活？
近三个月内没有 API 请求的开发版应用会被归档，归档后无法请求应用数据。
被归档的应用如需重新开启，可提供应用信息发邮件至 support@leancloud.rocks 申请激活。
4. 【计费】通过 API 发送实时通信消息收费吗？
使用 API 发送即时通信消息也是收费的。计费标准就是 API 调用费用标准（每万次 1.0 元）。
此项计费在控制台 > 财务 > 消费明细中对应扣费服务项目是：「数据存储（API 请求）」。
5.【小程序】小程序真机上传数据时，控制台存储中显示的 Class 表名被压缩为单个字母，这个是为什么？
例如新建一个名为「Todo」的表，上传数据成功后进入控制台查看，其表名称显示为像 i、u 这样的单个字母。
这是因为真机上代码会被压缩，解决办法是在创建 Class 后向 SDK 注册该 Class 的名字：AV.Object.register(Todo, 'Todo');。
6.【云引擎】在云引擎部署时，会显示[ERROR] exit status 128，请问会有什么影响吗？
是命令行工具在上传统计数据的时候的一个错误，不影响后续的部署，升级到最新版本的 lean-cli 就不会有这个提示了。
7.【CQL】LeanCloud 平台的 CQL 语句，与标准的 SQL 有什么区别。离线数据分析使用的 SQL 语句又有什么不同？
CQL 只是 API 的一点封装，是 SQL 的一个很小的子集，离线分析的 SQL 是 Hive SQL。标准 SQL 里面有很多内置的函数，CQL 里面都不支持。
也就是说标准 SQL 和离线分析的 Hive SQL 支持的内置函数有差异，而 CQL 基本不支持内置函数。
2018 年 12 月常见问题
1.使用即时通讯服务发送消息，消息大小有限制吗？
客户端发送的单条消息大小不得超过 5 KB。即时通信服务其他限制可以参考文档 即时通讯服务总览 - 限制 。
2.即时通讯服务支持类似微信的屏蔽聊天功能（静音）吗？
即时通讯有静音功能，假如某一用户不想再收到某对话的消息提醒，但又不想直接退出对话，可以使用静音操作，即开启「免打扰模式」。设置静音之后，iOS 用户和 Android 混合推送用户就不会收到推送消息了。
3.商用版计费最低消费 30 元，应用所有的费用都可以从这里面抵扣吗？
商用版应用每日最低消费中国节点 30 元人民币、国际节点 5 美元，最低消费不包含文件存储空间和文件流量的费用。除文件费用外其他消费都先从 30 元中扣除。
4.如何修改 IM 聊天推送消息图标？
对于 iOS 来说，推送无法动态修改图标。对于 Andorid 来说因为各家没有统一的标准说都支持修改还是都不支持修改，所以也无法统一的做到发个推送所有收消息设备都能自动改图标。
5.统计服务下线以后还能继续使用「自定义参数」功能吗？
「自定义参数」不会下线，但会并入存储模块，合并到存储 API 里面进行统一计费。
6.统计分析功能要下线了，我可以付费继续使用吗？
我们将逐步下线移动分析服务，时间计划如下：
2019 年 1 月 17 号之后，停止接收客户端上报的数据，但是老的统计结果依然在控制台展示，并且继续开放 REST API 供开发者获取这些数据；
2019 年 2 月 27 号之后，将停止老的数据展示以及 REST API 下载，统计分析功能会被彻底下线。
考虑到个别用户的使用情况，我们也提供将统计服务私有部署的选项（有一次性的部署费用），如果您有此需求可以通过邮件（support@leancloud.rocks）或工单联系我们。
7.使用网站托管功能一定要实名认证吗？
为了遵守相关法律法规，我们需要对所有使用了 LeanCloud 云引擎网站托管功能的用户进行实名认证。如果启用了云引擎的网站托管功能（设置了 .leanapp.cn 的二级域名），必须在控制台「帐号设置」中进行实名认证。如果在 2019 年 1 月 15 日前还未完成实名认证，我们会暂时撤销您的二级域名，互联网用户将无法直接访问。
8.美国节点不能使用支付宝充值吗？美国节点怎么开发票呢？
美国节点用户需要使用国外银行账户充值，或者通过 PayPal 充值。因为美国节点的运营主体已经切换为 LeanCloud 的境外公司（也就是 Paypal 付款的接收方），无法再以国内公司的名义开具发票，我们会和其他国外的服务商一样，每个月根据实际消费额为您生成电子发票。发票会在月账单出具后（通常是每个月 4 日）自动生成，可在控制台账单页面下载。
2018 年 11 月常见问题
1.使用命令行工具 CLI ：lean login 无法部署到美国节点，总是提示未登录
美国节点用户需要使用参数 --region=US 进行登录，华东节点使用 --region=TAB，不加 region 参数则默认为华北节点。
//美国节点
lean login --region US
//华东节点
lean login --region=TAB
//华北节点
lean login
2.创建 Class 时报错 154，创建失败为什么呢？
目前每个应用最多允许创建 300 个 Class，超出这个数量不允许再新建 Class，会报错 154 来提示。
3.客户端调用云函数计入 API 请求数吗？
调用云函数本身目前是不计入的，但云函数中产生的其他云存储请求是计入的。
2018 年 9 月- 10 月常见问题
1.使用 LeanCloud 短信服务，每个应用有多少条免费短信额度？
免费额度不是按照条数计算，每个 LeanCloud 账户有 5 元的免费短信额度，超出额度需要进行付费充值。
这里 5 元的免费额度是每个账户的额度，而不是每个应用。
2.发送短信时，一条短信里最多能编辑多少个字？
一条短信可编辑 70 个字符（含中英文标点）。小于或等于 70 个字符，均按一条计费。
超过 70 个字符则每条按照 67 个字符来计算条数，一条短信（手机中显示）最长可以发 400 字符。
400 字符的短信收费计算公式为：400/67 = 5.9， 也就是会扣 6 条短信费用。
3.国外用户可以使用国内节点吗？中国华北节点/中国华东节点/美国节点 这三个节点如何选择？
国外用户多数时间是可以访问国内节点的，但因跨境网络所以不能提供保证。
如果用户主体大部分在国外，建议选择美国节点。
如果用户主体大部分分布在华北区域，建议选择华北节点。
同理，如果用户主体多数分布在华东区域，建议选择华东节点。
4.LeanCloud 扣费方式在本月有调整。
文件存储服务不再参与抵扣每日的商用版最低消费。商用版最低消费不再延迟三天扣费，产生消费的次日即扣除商用版最低消费。
5.推送记录会保留多久，可不可以查询去年的推送记录？
推送记录只保留 7 天，7 天之前的推送记录无法查询。
6. Android 非混合推送设备，控制台推送记录中显示推送成功，但 Android 设备实际没有收到推送，该怎么排查原因？
对于 Android 非混合推送设备，当返回的记录成功数为 1 时，表示 SDK 确认收到该消息的回应。此条推送消息一定是到达了设备。
检查推送消息中有 action 字段，表示在使用自定义 Receiver 功能，消息到达后 SDK 会直接将消息转交给自定义 Receiver，由自定义 Receiver 完成推送提醒。
这种情况需要检查自定义 Receiver 实现逻辑排查消息到达后为什么没有弹出提醒。
7.即时通信服务中，一个房间内的消息有没有优先级？有些消息类型及时性要求特别高，有些消息及时性要求不高。
LeanCloud 有消息优先级的概念，为了保证消息的时效性，当聊天室消息过多导致客户端连接堵塞时，服务器端会选择性地丢弃部分低等级的消息。
当某个用户连接因为消息过多出现阻塞写入缓慢的情况下，用户可以考虑指定消息优先级，低优先级消息在堵塞时我们会丢弃，高优先级消息则永久排队等待下发。默认情况下消息都是高优先级。
此功能仅针对聊天室消息有效。普通对话的消息不需要设置等级，即使设置了也会被系统忽略，因为普通对话的消息不会被丢弃。
8.合同与财务发票类问题提交工单后的反馈
工单仅回复技术类问题。由于财务同事并不在工单系统，合同与财务发票类问题请发邮件至：support@leancloud.rocks。
2018 年 8 月常见问题
1.默认值的查询结果为什么不对？
这是默认值的限制。MongoDB 本身是不支持默认值，我们提供的默认值只是应用层面的增强，对于老数据只是在查询后做了展现层的优化。有两种解决方案：
- 对老的数据做一次更新，查询出 key 不存在 ( whereDoesNotExist ) 的记录，再更新回去。
- 查询条件加上 or 查询，or key 不存在 ( whereDoesNotExist ) 。
2. Egret 中调用 LeanCloud 出现 TypeError: Cannot read property ‘createdAt’ of null。
解决方案参考： https://github.com/leancloud/weapp-polyfill 这里的实现，直接修改 Egret 的 weapp-adapter.js 。
3. 请问域名备案的审核大概需要多久？
域名备案流程正常 20 个工作日，LeanCloud 会先提交初审，初审通过后会进行复审，最后递交管局审核。
2018 年 7 月常见问题
1.使用 Objective-C SDK 的文件下载注意事项
如下代码，从网络路径构建文件 file 对象后，直接调用 download 方法运行后会报错：
Error Domain=com.LeanCloud.ErrorDomain Code=1 "objectId invalid." UserInfo={NSLocalizedFailureReason=objectId invalid.
AVFile *file =[AVFile fileWithRemoteURL:[NSURL URLWithString:@"http://ww3.sinaimg.cn/bmiddle/596b0666gw1ed70eavm5tg20bq06m7wi.gif"]];
[file downloadWithProgress:^(NSInteger number) {
//下载的进度数据，number 介于 0 和 100。
} completionHandler:^(NSURL * _Nullable filePath, NSError * _Nullable error) {
// filePath 是文件下载到本地的地址
}];
这是因为文件下载方法 只能下载 File 表存在的 AVFile 对象 ，即下载的 file 对象需要存在 objectId。上面的代码构建文件对象后没有将图片上传到 File 表，所以下载时会找不到文件的 objectId 而报错。
2. React Native 环境中使用 JavaScript SDK 的应用内社交模块，报错找不到 AV.Status 这个类。
这是因为在 React Native 环境中，Status 功能需要用户登录才可以使用。请保证在调用相关的 API 之前，用户已经处于登录状态。
即在使用 AV.Status 之前调用过 AV.User.currentAsync()。
3. JavaScript SDK v3.0 以后的版本中为对象设置角色的访问权限的注意事项。
创建 Role 时 acl 参数不再是可选的。在 v2 中，如果不指定，SDK 会自动为其设置一个 public read-only 的默认 acl，在新版中必须显式的指定。
// v2.0 用法
new AV.Role('admin');
// v3.0 中等价于
var acl = new AV.ACL();
acl.setPublicReadAccess(true);
new AC.Role('admin', acl);
4. 云引擎 node.js 有结合 websocket 的使用教程吗？
node.js 结合 websocket 的使用 Demo: websocket 的使用 Demo
云引擎 Node.js 各类小 Demo 汇总项目： leanengine-nodejs-demos
2018 年 6 月常见问题
1.消息发送文本内容长度有限制吗？
客户端发送的单条消息大小不得超过 5 KB。当超过这个数值时，会报错：「4110-INVALID_ORIGIN」。
2.我的发票抬头写错了怎么办？
如果发票在后台的审核状态仍然在「审核中」，可以自行撤销后，更改为正确的发票抬头重新提交；如果是发票已经开出，收到快递后才发现抬头填错，请发邮件至 support@leancloud.rocks，说明情况，并将错误的发票寄回 LeanCloud 后，LeanCloud 重新开具。
5 月常见问题
1.云引擎命令行如何登录美国节点？
使用 lean login --region=US。
2.iOS 如何查看服务器返回的错误？
某个请求出错，SDK 会返回对应的错误信息。错误信息格式如下：
-
error.code：错误码，详见 文档。
-
error.domain：错误域名，只有当 error.domain = kLeanCloudErrorDomain 时，才是 LeanCloud 返回的错误。
-
error.localizedFailureReason：错误信息详情。
-
error.userInfo：其他信息，如历史版本的兼容信息等。
例如 User 表中已经存在一个叫 Tom 的用户，再次注册用户名为 Tom 会报错「用户已经存在」，示例代码如下：
AVUser *user = [AVUser user];
user.username = @"Tom";
user.password = @"cat!@#123";
[user signUpInBackgroundWithBlock:^(BOOL succeeded, NSError *error) {
// 获取 RESTAPI 返回的错误信息详情（SDK 11.0.0 及以上的版本适用）
if ([error.domain isEqualToString:kLeanCloudErrorDomain] && error.code == 202) {
NSString *errorMessage = error.localizedFailureReason;
if (errorMessage) {
// handle error message
}
}
}];
3.GPDR 要求欧洲用户的数据都保存在欧洲境内的服务器，如何处理？
两种方式：
一、在欧洲境内租用一个服务器，把 LeanCloud 的数据每天 导出 后转存过去。
二、更新 App 的用户协议，让用户 允许将其数据保留在欧盟境外。
4 月常见问题
1. 最近收到微信的通知，5 月 29 号将要更换服务器证书，需要进行根证书验证。LeanCloud 是否已经升级，并匹配微信官方的标准？
是的，LeanCloud 已经完成相关配置。开发者不用做任何改动。
2. 对象只允许创建一个 GeoPoint 属性吗？
是的，每个 AV.Object 数据对象中只能有一个 AV.GeoPoint 对象的属性。并且，地理位置的点不能超过规定的范围。纬度的范围应该是在 -90.0 到 90.0 之间，经度的范围应该是在 -180.0 到 180.0 之间。如果添加的经纬度超出了以上范围，将导致程序错误。
3. 第三方服务突然提示访问 IP 地址有变动，云引擎出口 IP 地址会变化吗？
是的，会有变化。但我们会尽可能减少出入口 IP 的变化频率，但 IP 突然变换的可能性仍然存在。因此在遇到与出入口 IP 相关的问题，我们建议先进入控制台来核实一下 IP 列表是否有变化。
如果开发者希望在第三方服务平台（如微信开放平台）上配置 IP 白名单而需要获取云引擎的入口或出口 IP 地址，请进入 控制台 > 云引擎 > 设置 > 出入口 IP 来自助查询。
2 月- 3 月常见问题
1. 文件存储的域名是不是发生了变化？
是的。由于不可抗力原因，华北节点上 LeanCloud 文件存储服务商默认提供的公用二级域名 qbox.me 和 clouddn.com 等域名已经失效，不再可用，切换到了公有域名 lcfile.com。
2. 开发上需要因此做什么变更吗？
您如果没有在任何地方写死文件 URL，不需要做任何变更操作。如果有的话，请替换文件域名里的：
- dn-i4obrreg 变更为 lc-i4obrreg。i4obrreg 是您应用 App ID 的前八位，保持不变即可。
- 域名 qbox.me 或者.clouddn.com 变更为 .cn-n1.lcfile.com。
比如，https://dn-i4obrreg.qbox.me/ixlrIWsVSIzOp57mJ7CVjFAVYCjkulWbYEVMaK65.jpg 会变更为https://lc-i4obrreg.cn-n1.lcfile.com/ixlrIWsVSIzOp57mJ7CVjFAVYCjkulWbYEVMaK65.jpg 。
3. 文件域名以后是否还会继续变化，或者不可用？如何将影响降低到最小？
仍然存在这种可能。为了规避 url 变更或者不可用的风险，建议您为华北节点上的应用绑定自定义文件域名，请前往应用控制台的「存储」->「设置」里自助绑定文件域名。
1 月常见问题
1.如何强制一个登录的 AVUser 用户下线？
应用场景：用户手机被偷了，然后因为手机上的应用一直有用户缓存，所以不需要用户密码就能登录成功。有没有办法强制该用户下线？
解决方案：在安全的云引擎后端环境里，使用 Master Key，调用 重置登录 sessionToken 的接口来强制刷新用户的 sessionToken。
2.云引擎升级到 3.x 后云函数返回的数据变了，如何操作？
从 leanengine 2 升级到 3 是一个大版本的升级，在这次升级中，我们把配套的 leancloud-storage 升级到了 3。在 leancloud-storage 3.0.0 中，我们重新设计了 AV.Object 的两个序列化方法： #toJSON 与 #toFullJSON。在新版中，AV.Object#toJSON 的定位是输出对象的有效信息，可以传给视图层直接消费。新增 AV.Object#toFullJSON，定位为序列化方法，输出包括类型信息在内的所有信息，可以用来实现对象的持久化。
在云引擎的两个远程调用的 API，AVCloud.run 对应的返回值是「数据」，因此在云引擎返回时我们会应用 #toJSON 方法，SDK 看到的是 Hashmap。而 AVCloud.rpc 对应的返回值是 AVObject，因此在云引擎返回时会应用 #toFullJSON 方法，SDK 解码后看到的是 AVObject|AVFile。
综上，这是 leanengine@3 中为了更好区别这两个 API 的使用场景，有计划的不兼容改动。
12 月常见问题
1.如何设置文件的独立域名？
请发邮件至 support@leancloud.rocks 向我们提供「要绑定应用的 App ID 」和一个没有用过的二级域名，比如 avfile.xxx.com，其中 xxx.com 必须是一个已备案有 ICP 号的域名。如果需要为文件设置 https 访问，请同时提供 SSL 证书（.crt）和无密码的私钥（.key）；
我们会回复给您一个域名地址，格式为 xxxxxx.qiniudns.com；
您将 avfile.xxx.com 的 CNAME 设置为 xxxxxx.qiniudns.com，然后通过邮件通知我们；
我们确认无误后便将您账户下的应用切换为指定的自定义域名 avfile.xxx.com，您可以在控制台中查看 _File 表来确认 URL 的合法性。
2.免费的离线数据分析比较慢，有更快的付费方案吗？
我们的离线分析独立部署，是根据业务需求来分步实施的。不同的环节独立出来费用是不一样的，主要有：
计算节点独立。这样的话可以保证应用有独立的 job 排队队列和执行节点，不会跟别的应用竞争（应用内排队还可能存在）。这种情况下，我们计费的基本单元是一个标准的计算节点（1 CPU / 2 G 内存）一个月费用 600元，应用可以根据自己的需求来购买不同数量的计算节点。
数据源独立。这是指，来源数据从数据库导入到单独的、专为计算分析优化的分布式存储系统，这样的计算过程会更加快速。这个方案成本较低，我们会每天做一次数据转储，费用按照每天转储数据量的峰值来收费（大概计费标准是 300 元/G/月——每天转储的数据规模不超过 1G，那么一个月费用 300 元）。但是该方案的数据是每天转储一次的，所以使用时会有一天的延迟。
如果希望对实时数据进行分析计算，并且还希望每次都能非常快速地得到结果，就需要对底层数据库进行独立部署，这一操作费用会比较高。
11 月常见问题
1. AVFile 被删除之后，文件的 URL 为什么还可以被访问？
文件在存储成功之后，为了保证访问速度，会在各个 cdn 节点上全部复制一份。而删除该文件后，同样需要去各个 cdn 节点上依次进行删除。目前这个过程，一般需要 1 个工作日的时间。
2. Android 8.0 系统下，PushService 会引起崩溃？
这个问题是 8.0 系统的权限收紧引起的。大家可以在 AVOSCloud.initialize 之前调用代码 PushService.setAutoWakeUp(false)，禁止掉 PushService 的自启动。这样能暂时规避这个问题。
与此同时，我们预计在 11 月底发布对 Android 8.0 的全面适配。
3. 云引擎中如何直接访问一个静态文本文件？
如果要让 webServer 访问静态文件，需要使用 static 中间件，或者类似于 示例项目 配置的方式配置一个目录，然后把静态文件保存在该目录中再访问。
10 月常见问题
1. 我新建了一个应用，想做一些测试数据。如何把旧应用的数据复制过来？
答：先在旧应用导出数据，操作步骤参见：https://leancloud.cn/docs/dashboard_guide.html# 云端数据导出到本地。然后下载账户邮箱收到的导出数据，导入新应用，操作步骤参见：https://leancloud.cn/docs/dashboard_guide.html# 本地数据导入_LeanCloud.
2. 为什么云引擎 Ｎode.js 环境不能通过 AV.User.current() 获取 currentUser？
答：云引擎 Node.js SDK 是供云引擎访问 LeanCloud API 的 Node 模块，它内部依赖了 JavaScript SDK. 但和在浏览器中不同，云引擎是一个「多用户」的环境，作为服务器端程序需要同时处理来自不同用户的请求。而 Node.js 本身是异步模型，这些来自不同用户的请求会交织在一起，在同一个全局作用域中运行。
JavaScript SDK 提供了 AV.User.current() 和其他一些函数全局地设置或获取用户状态，当（通过 AV.User.logIn 或 AV.User.become）设置了用户状态，后续的所有请求都会附带上这个用户的 sessionToken, 以便服务器知道以哪个用户的权限去执行这次操作。
更详细的参见：https://leancloud.cn/docs/leanengine-node-sdk-upgrade-1.html# 废弃_currentUser
