数据存储常见问题

API 调用次数有什么限制吗

开发版提供每天三万次的免费额度。 推送服务免费使用，并不占用免费额度，推送消息接口的调用受频率限制，具体参考：推送消息接口的限制 文档。

默认情况下，商用版应用同一时刻最多可使用的工作线程数为 60，即同一时刻最多可以同时处理 60 个数据请求。我们会根据应用运行状况以及运维需要调整该值。如果需要提高这一上限，请 提交工单 进行申请。

API 调用次数的计算

对于数据存储来说，每次 create 和 update 一个对象的数据算 1 次请求，如调用 1 次 object.saveInBackground 算 1 次 API 请求。在 API 调用失败的情况下，如果是由于 应用流控超限（错误码 429） 而被云端拒绝，则不会算成 1 次请求；如果是其他原因，例如 权限不够（错误码 430），那么仍会算为 1 次请求。

一次请求

• create
• save
• fetch
• find
• delete
• deleteAll

调用一次 fetch 或 find 通过 include 返回了 100 个关联对象，算 1 次 API 请求。调用一次 find 或 deleteAll 来查找或删除 500 条记录，只算 1 次 API 请求。

多次请求

• saveAll
• fetchAll

调用一次 saveAll 或 fetchAll 来保存或获取 array 里面 100 个 对象，算 100 次 API 请求。

对于 社交信息流，create 和 update 按照 Status 和 Follower/Followee 的对象数量来计费。

对于 query 则是按照请求数来计费，与结果的大小无关。query.count 算 1 次 API 请求。collection fetch 也是按照请求次数来计费。

如何获取 API 的访问日志

进入 控制台 > 数据存储 > API 访问日志，开启日志服务，稍后刷新页面，就可以看到从开启到当前时间产生的日志了。

其他语言调用 REST API 如何对参数进行编码

REST API 文档使用 curl 作为示范，其中 --data-urlencode 表示要对参数进行 URL encode 编码。如果是 GET 请求，直接将经过 URL encode 的参数通过 & 连接起来，放到 URL 的问号后。如 https://API_BASE_URL/1.1/login?username=xxxx&password=xxxxx。

如何实现大小写不敏感的查询

目前不提供直接支持，可采用正则表达式查询的办法，具体参考 StackOverflow - MongoDB: Is it possible to make a case-insensitive query。

使用各平台 SDK 的 AVQuery 对象提供的 matchesRegex 方法（Android SDK 用 whereMatches 方法）。

应用内用户的密码需要加密吗

不需要加密密码，我们的服务端已使用随机生成的 salt，自动对密码做了加密。 如果用户忘记了密码，可以调用 requestResetPassword 方法（具体查看 SDK 的 AVUser 用法），向用户注册的邮箱发送邮件，用户以此可自行重设密码。 在整个过程中，密码都不会有明文保存的问题，密码也不会在客户端保存，只是会保存 sessionToken 来标示用户的登录状态。

查询最多能返回多少结果？

• 查询最多返回 1000 条数据。
• 返回的查询结果不止一个时，总大小不超过 6 MB（为了兼容旧客户端，超过 6 MB 时不会报错，会返回截断的结果）；返回一个查询结果时，大小不超过 16 MB。

查询结果最多只能返回 1000 条数据，当我需要的数据量超过了 1000 该怎么办？

可以通过每次变更查询条件，来继续从上一次的断点获取新的结果，譬如：

• 第一次查询，createdAt 时间在 2015-12-01 00:00:00 之后的 1000 条数据（最后一条的 createdAt 值是 x）；
• 第二次查询，createdAt 在 x 之后的 1000 条数据（最后一条的 createdAt 是 y）；
• 第三次查询，createdAt 在 y 之后的 1000 条数据（最后一条是 z）；

以此类推。

使用 CQL 子查询时查不到记录或查到的记录不全

使用子查询可能会遇到查不到记录或查到的记录不全的情况。例如：

-- 找出积分高于 80、region 为 cn 的玩家记录
SELECT *
FROM   player
WHERE  NAME IN (SELECT NAME
                FROM   gamescore
                WHERE  score > 80)
       AND region = 'cn'

LeanCloud 云端使用的并非关系型数据库，无法做到真正的联表查询，所以实际的处理方式是：先执行内嵌/子查询（和普通查询一样，limit 默认为 100，最大 1000），然后将子查询的结果填入主查询的对应位置，再执行主查询。

如果子查询匹配到了 100 条以上的记录（性别等区分度低的字段重复值往往较多），且主查询有其他查询条件（region = 'cn'），那么可能会出现没有结果或结果不全的情况，其本质上是子查询查出的 100 条记录没有满足主查询的其他条件。

我们建议采用以下方案进行改进：

• 确保子查询的结果在 100 条以下，如果在 100 - 1000 条的话请在子查询末尾添加 limit 1000。
• 将需要查询的字段冗余到主查询所在的表上；例如将 score 冗余到 Player 表上，或者将 region 添加到 GameScore 上然后只查 GameScore 表。
• 进行多次查询，每次在子查询上添加 skip 来遍历所有记录（注意 skip 的值较大时可能会引发性能问题，因此不是很推荐）。

可以通过指定 objectId 范围来实现分页吗？

当前 LeanCloud 系统自动生成 objectId 的算法是基于时间的，因此确实可以通过指定 objectId 范围来实现分页。 但是，从代码可读性及严谨性出发（比如导入数据时可以指定不同格式的 objectId），推荐通过指定 createdAt 范围来实现分页。

当数据量越来越大时，怎么加快查询速度？

与使用传统的数据库一样，查询优化主要靠索引实现。索引就像字典里的目录，能帮助你在海量的文字中更快速地查词。

原则：数据量少时，不建索引。多的时候请记住，建立索引后，写入时还需要更新索引，以此来换取更少的查询时间。所以，一般来说，写少读多就多建索引，写多读少就少建索引。

索引可以在控制台自助创建，详见控制台使用指南

LeanCloud 查询支持 Sum、Group By、Distinct 这种函数吗？

不支持。Group By 查询往往涉及大量对象的遍历，数据存储并不适用这样的场景。

为此我们推荐使用「数据仓库」功能，它支持大量和高效的数据遍历，为数据分析这一场景量身定制。

sessionToken 在什么情况下会失效？

如果在控制台的存储的设置中勾选了「密码修改后，强制客户端重新登录」，则用户修改密码后， sessionToken 会变更，需要重新登录。如果没有勾选这个选项，Token 就不会改变。当新建应用时，这个选项默认是被勾上的。

默认值的查询结果为什么不对

这是默认值的限制。MongoDB 本身是不支持默认值，我们提供的默认值只是应用层面的增强，老数据如不存在相应的 key，设置默认值后并不会订正数据，只是在查询后做了展现层的优化。相应地，变更默认值后，这些 key 也会显示为新的默认值。有两种解决方案：

1. 对老的数据做一次更新，查询出 key 不存在（whereDoesNotExist）的记录，再更新回去。
2. 查询条件加上 or 查询，or key 不存在（whereDoesNotExist）。

如何查询非空值？

空值的具体语义取决于字段的类型和项目的实际情况。以字符串字段为例，空值可能意味着：

1. 该字段不存在
2. 该字段为 null
3. 该字段为空字符串 ""

相应地，查询该字段非空的条件为 where={"some_field": {"$exists": true, "$nin": ["", null]}}。

在项目的数据模型设计阶段确定严谨的规范，有助于简化查询条件，避免因为不小心遗漏情况而出错。 例如，如果在设计上确保字符串字段为空时干脆不设置字段（不存在），永不将其设为 "" 和 null（强烈不推荐将字段设为 null，SDK 未提供将字段设为 null 的方法），那么只需查询 {"$exists": true} 即可。

如何解决数据一致性或事务需求？

LeanCloud 目前并不提供完整的事务功能，但提供了一些保证数据一致性的特性，可以解决大部分的一致性需求：

• 在单个对象的一次 save 操作中，对多个字段的更新操作是原子地完成的。
• 使用 increment（原子计数器）可以原子地更新数字字段。
• 唯一索引 可以保证在一个字段上有同样值的对象只有一个。
• 有条件更新对象 可以仅在满足某个查询条件时进行更新操作；在这个特性的基础上，你可以自己实现更加复杂的 两阶段提交。
• 在云引擎上还可以借助 LeanCache 来实现自定义的 排他锁。

关于这个话题我们还录制了一期公开课视频：在 LeanCloud 上解决数据一致性问题，其中有对上面这些特性的详细介绍，和解决常见场景的实例教程（包括实现两阶段提交）。

文件存储有 CDN 加速吗？

文件存储有大小限制吗？

没有。除了在浏览器里通过 JavaScript SDK 上传文件，或者通过我们网站直接上传文件，有 10 MB 的大小限制之外，其他 SDK 都没有限制。 JavaScript SDK 在 Node.js 环境中也没有大小限制。

存储图片可以做缩略图等处理吗？

可以。默认我们的 AVFile 类提供了缩略图获取方法，可以参见各个 SDK 的开发指南。如果要自己处理，可以通过获取 AVFile 的 URL 属性。

使用 七牛图片处理 API 执行处理，例如添加水印、裁剪等。

文件存储支持访问控制吗？

由于知道文件 URL 的任何用户都可以访问文件，因此需要为 _File Class 和引用文件的 Class 设置合适的 Class 权限和 ACL，限制未授权用户获取到文件 URL。

如果希望能够更精细地控制文件访问权限，比如在一定时间后重新检查是否有权访问文件，建议使用支持访问权限控制的第三方文件存储服务商，然后直接在 LeanCloud 文件服务中保存一个外部的 URL。 注意 _File 表是不可变的，这意味着已经写入的 URL 不能修改。 但通常支持访问权限控制的文件存储服务商，实现访问权限的方式都是在现有的 URL，比如 https://file.example.com/some-url 后额外传入一个 token 参数（这个 token 通常有时效性），比如 https://file.example.com/some-url?token=xxxxxx。 所以客户端需要访问文件时，可以先从 LCFile 获取 url 属性后，再加上这个 token 参数，拼成最终的 URL 下载文件。 token 的获取需要自行在云引擎或自己的服务器上部署一个简单的生成访问 token 的 API 服务，客户端访问该 API 服务获取 token。

如何修改文件存储中已有的文件？

文件存储对应的 _File Class 是不可变数据，文件内容和相关元数据一经写入就无法修改，只能删除后重新上传或重新通过 URL 构建。 在使用外部文件（通过 URL 构建文件）的情况下，如果有频繁修改文件或相关元数据的需求，可以考虑如下方案：

• 自己实现一个存储外部文件相关信息的 Class，比如 ExternalFile。在引用该文件的对象中设置 Pointer 字段，指向 ExternalFile。注意，这种情况下，查询包含文件的对象时，如果希望同时获取文件信息，需要 include 相应字段（使用内置 _File Class 的情况下会自动 include，不用另外指定）。
• 在需要引用文件的对象中，直接使用字符串类型保存 URL。这种情况下文件相关功能都需要自行实现。如果想要保存这个文件的相关元信息，还需要另外设计。比如在对象的其他字段上保存，或者将相应字段的类型从字符串改成 object，同时保存 URL 和元信息。注意，如此设计会导致应用的文件信息分散在需要用到文件的各个 Class 中，要对整个应用的文件进行批量查询和批量处理会比较麻烦。

iOS 项目打包后的大小

创建一个全新的空白项目，使用 CocoaPod 安装了 AVOSCloud 和 AVOSCloudIM 模块，此时项目大小超过了 80 MB。打包之后体积会不会缩小？大概会有多大呢？

LeanCloud iOS SDK 二进制中包含了 i386、armv7、arm64 等 5 个 CPU slices。发布过程中，non-ARM 的符号和没有参与连接的符号会被 strip 掉。因此，最终应用体积不会增加超过 10 MB，请放心使用。

地理位置查询错误

如果错误信息类似于 can't find any special indices: 2d (needs index), 2dsphere (needs index), for 字段名，就代表用于查询的字段没有建立 2D 索引，可以在 Class 管理的 其他 菜单里找到 索引 管理，点击进入，找到字段名称，选择并创建「2dsphere」索引类型。

Java SDK 对 AVObject 对象使用 getDate("createdAt") 方法读取创建时间为什么会返回 null

请用 AVObject 的 getCreatedAt 方法；获取 updatedAt 用 getUpdatedAt。 这两个方法会返回 Date 类型。 如果希望返回字符串类型，可以使用 getUpdatedAtString() 和 getCreatedAtString()。

Android 设备每次启动时，installationId 为什么总会改变？如何才能不改变？

可能有以下两种原因导致这种情况：

• SDK 版本过旧，installationId 的生成逻辑在版本更迭中有修改。请更新至最新版本。
• 代码混淆引起的，注意在 proguard 文件中添加 LeanCloud SDK 的混淆排除。

Android 代码混淆怎么做

参考 Android 代码混淆 文档。

Java SDK 出现 already has one request sending 错误是什么原因

日志中出现了 com.avos.avoscloud.AVException: already has one request sending 的错误信息，这说明存在对同一个 AVObject 实例对象同时进行了 2 次异步的 save 操作。为防止数据错乱，LeanCloud SDK 对于这种同一数据的并发写入做了限制，所以抛出了这个异常。

需要检查代码，通过打印 log 和断点的方式来定位究竟是由哪一行 save 所引发的。

JavaScript SDK 有没有同步 API

JavaScript SDK 由于平台的特殊性（运行在单线程运行的浏览器或者 Node.js 环境中），不提供同步 API，所有需要网络交互的 API 都需要以 callback 的形式调用。我们提供了 Promise 模式 来减少 callback 嵌套过多的问题。

JavaScript SDK 在 AV.init 中用了 Master Key，但发出去的 AJAX 请求返回 206

目前 JavaScript SDK 在浏览器（而不是 Node）中工作时，是不会发送 Master Key 的，因为我们不鼓励在浏览器中使用 Master Key，Master Key 代表着对数据的最高权限，只应当在后端程序中使用。

如果你的应用的确是内部应用（做好了相关的安全措施，外部访问不到），可以在 AV.init之后增加下面的代码来让 JavaScript SDK 发送 Master Key：

AV.Cloud.useMasterKey(true);

JavaScript SDK 会暴露 App Key 和 App Id，怎么保证安全性？

首先请阅读「安全总览」来了解 LeanCloud 完整的安全体系。其中提到，可以使用「安全域名 」，在没有域名的情况下，可以使用「ACL」。 理论上所有客户端都是不可信任的，所以需要在服务端对安全性进行设计。如果需要高级安全，可以使用 ACL 方式来管理，如果需要更高级的自定义方式，可以使用 LeanEngine（云引擎）。

如何提升标志位的查询效率？

当数据表中有很多布尔类型的数据时，可以考虑使用二进制存储提高查询效率。例如需要存储是否开启推送、是否静音、是否为会员等多个状态，可以这样表示：

111：开启推送、静音、是会员

101：开启推送、未静音、是会员

在 LeanCloud 存储为整型字段，操作这个字段的方法可以参考位运算的接口文档：REST API - 位运算。

应用内搜索的关键字查询， 查出来的结果是两月前的数据，最新数据查询不到怎么办？

这种情况可以在控制台尝试重建索引，索引创建完后会有邮件提醒。

一般来说当用户上传了新的词典，或者有批量删除过数据等情况都需要执行一次「重建索引」操作。当发现搜索与存储数据不一致时，也可以尝试重建索引来解决。

在 PC 端用手机号登录，在小程序上用微信登录，如何绑定到同一个账号上？

从逻辑上，在 PC 端登录的账号，与在小程序中用微信登录的账号，他们没有任何可以联系在一起的地方。如果都是独立创建了两个账号，只能在业务层面进行绑定（也就是将一个账号的所有关联对象全都迁移到另一个账号，然后删除原账号）。

如果可以在业务上加一些限制，则可以避免上面这种「创建了两个独立的账号」的情况。比如，如果手机号是账号必须设置的信息，那么我们可以在以手机号作为关联项。具体的步骤如下，首先是 loginWithWeapp 并带上 failOnNotExist 参数，这样如果该微信关联的用户已经存在则照常登录，如果没有则会失败，此时跳转到使用手机号登录/注册的页面，让用户通过手机号登录或注册，成功之后再通过 associateWithWeapp 接口关联当前微信账号。

不通过短信验证能否强制修改 _User 表 mobilePhoneVerified 字段，使其设置为 true?

可以通过云引擎使用 master key 来修改 mobilePhoneVerified 的值。因为云引擎运行在可信的服务器端环境中，所以可以全局开启超级权限（Master Key），这样云端会跳过包括 ACL 和 Class 权限在内的检查，让你自由地操作所有云存储中的数据，当然这种方式也只允许调用一些仅供 Master Key 使用的 API。

某张表单个对象过大，导致请求速度较慢怎么办？

单个对象的数据过大，需要在业务层去优化代码，比如 data 是大数据字段：

• 在查询的时候，通过 AVQuery.Select 去选取需要的字段（不要 select data 字段）
• 在 GET 对象的时候，才把 data 字段获取到客户端。
• 或者考虑将 data 字段的数据做为「文件」保存，然后在表中通过 Pointer 关联起来。
• 如果 data 是一个巨大的对象且只需要获取其中某个或某几个属性的话，可以考虑在 select 时用点号指定相应的属性，文档参考：在查询对象时使用点号。

如何防止 DDoS 攻击，或者高频次的 CC 攻击？

无论是 DDoS 攻击，还是高频次的 CC 攻击，均需要在业务所请求的独立 IP 前架设高防资源。 具体步骤如下：

1. 在控制台绑定已备案的域名。使用数据存储与即时通讯服务需绑定 API 域名，使用云引擎服务需绑定云引擎域名。SDK 初始化的时候，指定 Server URL 为控制台绑定的 API 域名地址。绑定域名在控制台 > 应用 > 设置 > 域名绑定处操作。
2. 绑定域名时将 DNS 解析设置为独立的 IP（设置 IP 地址为 A 记录）。独立 IP 在控制台个人中心 > 账号设置 > 独立 IP 处可以查看，API 与云引擎分别对应不同的 IP。商用版用户会免费赠送一个 API 独立 IP，购买的第二个 API 独立 IP 开始收费，云引擎没有免费 IP。每个 IP 每月收费 50 元。
3. 在第三方购买高防资源，并使用上面新购的 IP 来回源。

由于很多网络攻击的目的地都是特定 IP，如果独立 IP 已随业务公开，可以另外购买一个独立 IP 来做为高防资源的回源 IP，以避免高防资源因源 IP 不可用而失效。

保存数据时报错 The key is too long，是什么问题？

可以检查要保存或更新的字段是否设置了索引，有索引的字段长度限制不能超过 1 KB。