云引擎常见问题和解答

云引擎都支持哪些语言

目前支持 Node.js、Python、Java 和 PHP 运行环境，未来可能还会引入其他语言。

云引擎的二级域名多久生效

我们设置的 TTL 是 5 分钟，但各级 DNS 服务都有可能对其进行缓存，实际生效会有一定延迟，最长可能需要几个小时。

云引擎支持 HTTPS 吗

• 对于 .leanapp.cn 的二级域名我们默认支持 HTTPS，如需配置自动跳转，请看 重定向到 HTTPS。
• 自定义的域名需要在进行 域名绑定 时上传证书才可以支持 HTTPS。

为什么 Class Hook 没有被运行？

首先确认一下 Hook 被调用的时机是否与你的理解一致：

• beforeSave：对象保存或创建之前
• afterSave：对象保存或创建之后
• beforeUpdate：对象更新之前
• afterUpdate：对象更新之后
• beforeDelete：对象删除之前
• afterDelete：对象删除之后
• onVerified：用户通过邮箱或手机验证后
• onLogin：用户在进行登录操作时

还需注意在本地进行云引擎调试时，运行的会是线上预备环境的 Hook，如果没有预备环境则不会运行。

然后检查 Hook 函数是否被执行过：

可以先在 Hook 函数的入口打印一行日志，然后进行操作，再到 云引擎日志 中检查该行日志是否被打印出来，如果没有看到日志原因可能包括：

• 代码没有被部署到正确的应用
• 代码没有被部署到生产环境（或没有部署成功）
• Hook 的类名不正确

如果日志已打出，则继续检查函数是否成功，检查控制台上是否有错误信息被打印出。如果是 before 类 Hook，需要保证 Hook 函数在 15 秒内结束，否则会被系统认为超时。

after 类 Hook 超时时间为 3 秒，如果你的体验实例已经休眠，很可能因为启动时间过长无法收到 after 类 Hook，建议升级到云引擎的标准实例避免休眠。

相关文档：云引擎指南：Hook 函数

命令行工具在本地调试时提示 Error: listen EADDRINUSE :::3000，无法访问应用

listen EADDRINUSE :::3000 表示你的程序默认使用的 3000 端口被其他应用占用了，可以按照下面的方法找到并关闭占用 3000 端口的程序：

• macOS 使用 lsof 和 kill
• Linux 使用 fuser
• Windows 使用 netstat 和 taskkill

也可以修改命令行工具默认使用的 3000 端口：

lean -p 3002

Application not found 错误

访问云引擎服务时，服务端返回错误「Application not found」或在云引擎日志中出现同一错误。

• 调用错了环境。最常见的情况是，免费的体验实例是没有预备环境，开发者却主动设置去调用预备环境。
• ???.leanapp.cn 二级域名填错了，比如微信回调地址。请确认与 ??? 的拼写完全一致。

云函数有哪些限制？

云函数是 LeanCloud 提供的一个 相对受限 的自定义服务器端逻辑的功能，和我们的 SDK 有比较 深度的集成。我们将云函数设计为一种类似 RPC 的机制，在云函数中你只能关注参数和结果，而不能自定义超时时间、HTTP Method、URL，不能读取和设置 Header。如果希望更加自由地使用这些 HTTP 的语义化功能，或者希望使用第三方的框架提供标准的 RESTful API，请使用云引擎的 网站托管功能，自行来处理 HTTP 请求。

如何判断当前是预备环境还是生产环境？

请参考 网站托管开发指南 · 预备环境和生产环境 。

怎么添加第三方模块

只需要像普通的 Node.js 项目那样，在项目根目录的 package.json 中添加依赖即可：

{
  "dependencies": {
    "async": "0.9.0",
    "moment": "2.9.0"
  }
}

dependencies 内的内容表明了该项目依赖的三方模块（比如示例中的 async 和 moment）。关于 package.json 的更多信息见 网站托管开发指南 · package.json。

然后即可在代码中使用第三方包（var async = require('async')），如需在本地调试还需运行 npm install 来安装这些包。

注意：命令行工具部署时是不会上传 node_modules 目录，因为云引擎服务器会根据 package.json 的内容自动下载三方包。所以也建议将 node_modules 目录添加到 .gitignore 中，使其不加入版本控制。

Maximum call stack size exceeded 如何解决？

将 JavaScript SDK 和 Node SDK 升级到 1.2.2 以上版本可以彻底解决该问题。

如果你的应用时不时出现 Maximum call stack size exceeded 异常，可能是因为在 hook 中调用了 AV.Object.extend。有两种方法可以避免这种异常：

• 升级 leanengine 到 v1.2.2 或以上版本
• 在 hook 外定义 Class（即定义在 AV.Cloud.define 方法之外），确保不会对一个 Class 执行多次 AV.Object.extend

我们在 JavaScript 指南 - 构建对象 章节中也进行了描述。

如何排查云引擎 Node.js 内存泄漏

如果对内存增长有疑问，可以在 package.json 中添加如下配置，开启 GC 日志来调试：

···
"start": "node --trace_gc server.js",
···

增加参数 --trace_gc，这样每次 GC 会在本地的 Console 或在控制台的云引擎日志中输出。

如何进行域名备案和域名绑定？

只有网站类的才需要备案，并且在主域名已备案的情况下，二级子域名不需要备案。如果主站需要托管在我们这边，且还没有备案过，请进入 应用控制台 > 账号设置 > 域名备案 和 域名绑定，按照步骤提示操作即可。

调用云引擎方法如何收费？

云引擎中如果有 LeanCloud 的存储等 API 调用，按 API 收费策略 收费。另外如果使用的是云引擎 标准实例 也会产生使用费，具体请参考 云引擎运行方案。

「定义函数」和「Git 部署」可以混用吗？

「定于函数」的产生是为了方便大家初次体验云引擎，或者只是需要一些简单 hook 方法的应用使用。我们的实现方式就是把定义的函数拼接起来，生成一个云引擎项目然后部署。

所以可以认为「定义函数」和 「Git 部署」最终是一样的，都是一个完整的项目。

是一个单独功能，可以不用使用基础包，git 等工具快速的生成和编辑云引擎。

当然，你也可以使用基础包，自己写代码并部署项目。

这两条路是分开的，任何一个部署，就会导致另一种方式失效掉。

如何从「在线编辑」迁移到项目部署？

1. 按照 命令行工具使用指南 安装命令行工具，使用 lean init 初始化项目，模板选择 node-js-getting-started（我们的 Node.js 示例项目）。
2. 在 应用控制台 > 云引擎 > 部署 > 在线编辑 中点击 预览，将全部函数的代码拷贝到新建项目中的 cloud.js（替换掉原有内容）。
3. 检查 cloud.js 的代码，将 AV.User.current() 改为 request.currentUser 以便从 Node SDK 的 0.x 版本升级到 1.x，有关这个升级的更多信息见 升级到云引擎 Node.js SDK 1.0。
4. 运行 lean up，在 http://localhost:3001 的调试界面中测试云函数和 Hook，然后运行 lean deploy 部署代码到云引擎（使用标准实例的用户还需要执行 lean publish）。
5. 部署后请留意云引擎控制台上是否有错误产生。

为什么云函数中 include 的字段没有被完整地发给客户端？

将 JavaScript SDK 和 Node SDK 升级到 3.0 以上版本可以彻底解决该问题。

云函数在响应时会调用到 AV.Object#toJSON 方法，将结果序列化为 JSON 对象返回给客户端。在早期版本中 AV.Object#toJSON 方法为了防止循环引用，当遇到属性是 Pointer 类型会返回 Pointer 元信息，不会将 include 的其他字段添加进去，我们在 JavaScript SDK 3.0 中对序列化相关的逻辑做了重新设计，将 JavaScript SDK 和 Node SDK 升级到 3.0 以上版本便可以彻底解决该问题。

如果暂时无法升级 SDK 版本，可以通过这样的方式绕过：

AV.Cloud.define('querySomething', function(req, res) {
  var query = new AV.Query('Something');
  // user 是 Something 表的一个 Pointer 字段
  query.include('user');
  query.find().then(function(results) {
    // 手动进行一次序列化
    results.forEach(function(result){
      result.set('user', result.get('user') ?  result.get('user').toJSON() : null);
    });
    // 再返回查询结果给客户端
    res.success(results);
  }).catch(res.error);
});

Gitlab 部署常见问题

很多用户自己使用 Gitlab 搭建了自己的源码仓库，有时可能会遇到无法部署到 LeanCloud 的问题，即使设置了 Deploy Key，却仍然要求输入密码。

可能的原因和解决办法如下：

• 确保你 Gitlab 运行所在服务器的 /etc/shadow 文件里的 git（或者 gitlab）用户一行的 !修改为 *，原因参考 Stackoverflow - SSH Key asks for password，并重启 SSH 服务：sudo service ssh restart。
• 在拷贝 Deploy Key 时，确保没有多余的换行符号。
• Gitlab 目前不支持有注释的 Deploy Key。早期 LeanCloud 用户生成的 Deploy Key 末尾可能带有注释（类似于 App dxzag3zdjuxbbfufuy58x1mvjq93udpblx7qoq0g27z51cx3's cloud code deploy key），需要删除掉这部分再保存到 Gitlab。

Exceeded Limit 是什么意思？

很多用户使用云引擎时会遇到 http 响应码为 529 的错误页面：

Exceeded Limit
当前 IP [118.186.7.27] 超过并发限制。

这是因为云引擎的网站托管服务对每个广域网 IP 有 60 个连接的限制，来防止恶意用户使用较低的成本对云引擎应用发起较大的攻击。

如果正常使用时遇到这个问题，一般是由以下场景所触发：

• 一个办公室很多人都访问同一个云引擎应用：因为整个办公室出口 IP 是一样的，所以相对比较容易达到限制。
• 自有服务器与云引擎通信：可能短时间产生大量请求，导致达到限制。
• 应用响应很慢：导致请求不能迅速释放，请求堆积导致达到限制。

解决办法：

• 对于前两种情况，建议使用 自定义域名 绑定到云引擎，这样限制会扩大到每个 IP 允许 300 个连接。
• 如果是最后一种情况，建议优化云引擎的业务降低响应时间，或者绑定 自定义域名。

npm ERR! peer dep missing 错误怎么办？

部署时出现类似错误：

npm ERR! peer dep missing: graphql@^0.10.0 || ^0.11.0, required by express-graphql@0.6.11

说明有一部分 peer dependency 没有安装成功，因为线上只会安装 dependencies 部分的依赖，所以请确保 dependencies 部分依赖所需要的所有依赖也都列在了 dependencies 部分（而不是 devDependencies）。

你可以在本地删除 node_modules，然后用 npm install --production 重新安装依赖来重现这个问题。

在线上无法读取到项目中的文件怎么办？

建议先检查文件大小写是否正确，线上的文件系统是区分大小写的，而 Windows 和 macOS 通常不区分大小写。

部署时长时间卡在「正在下载和安装依赖」怎么办？

这个步骤对应在云端调用各个语言的包管理器（npm、pip、composer、maven）安装依赖的过程，我们有一个 依赖缓存 机制来加速这个安装过程，但缓存可能会因为很多原因失效（比如修改了依赖列表），在缓存失效时会比平时慢很多，请耐心等待。如果你在 leanengine.yaml 中指定了系统依赖也会在这个步骤中安装，因此请不要添加未用到的依赖。

对于 Node.js 建议检查是否在 package-lock.json 或 yarn.lock 中指定了较慢的源（见 网站托管开发指南 · Node.js）。

云引擎的健康检查是什么？

云引擎的管理系统会每隔几分钟检查所有实例的工作状态（通过 HTTP 检查，详见 网站托管开发指南：健康监测），如果实例无法正确响应的话，管理系统会触发一次重新部署，并在控制台上打印类似下面的日志：

健康检查失败：web1 检测到 Error connect ECONNREFUSED 10.19.30.220:51797

如果一周内发生一两次属正常现象（有可能是我们的服务器出现偶发的故障，因为会立刻重新部署，对服务影响很小），如果频繁发生可能是你的程序资源不足，或存在其他问题（运行一段时间后不再响应 HTTP 请求），需结合具体情况来分析。

如何使用云引擎批量更新数据？

可以参考我们的 Demo: batch-update。

如何下载云引擎的应用日志和访问日志

云引擎的应用日志（程序的标准输出和标准错误输出）可以在 应用控制台 > 云引擎 > 应用日志 查看；并且可以使用 命令行工具 导出最长 7 天的日志。

云引擎的访问日志（Access Log）可在 应用控制台 > 云引擎 > 访问日志 中导出，通过控制台下载经过打包的日志。

如何定制 Java 的堆内存大小？

云引擎运行 Java 应用时，会自动将 -Xmx 参数设置为实例规格的 70%，剩下的 30% 留给堆外内存和其他开销。如果的应用比较特殊（比如大量使用堆外内存）可以自己定制 -Xmx 参数。假设使用 2 GB 内存规格的实例运行，则可以在云引擎的设置页面增加「自定义环境变量」，名称为 JAVA_OPTS，值为 -Xmx1500m，这样会限制 JVM 堆最大为 1.5 GB，剩下 500 MB 留给持久代、堆外内存或者其他一些杂项使用。注意：-Xmx 参数如果设置得过小可能会导致大量 CPU 消耗在反复的的 GC 任务上。