最佳实践

调试云函数

最近更新时间:2021-09-17 11:08:34

云函数控制台现已支持在线调试功能,您可以通过控制台调试与定位问题。

注意:

目前在线调试功能仅支持使用 Chrome 浏览器,以及仅支持 Node.js 10.15 和 Node.js 12.16 开发语言。

开启调试模式

注意:

在使用在线调试之前,需要您手动开启函数的调试模式。开启函数的调试模式将会变更函数的部分配置,关闭调试模式后将会恢复,可能对您的业务产生影响,请您务必确认以下内容:

  • 该函数将进入单实例模式,同一时间该函数所有版本只能响应一个事件,并发超出的事件将会调用失败。
  • 执行超时时间调整为900秒,调试期间执行超时时间不可设置。
  • 预置多个实例会缩至单个实例。
  • 开启调试模式的函数执行性能会降低。
  1. 登录 云函数控制台,在左侧选择函数服务
  2. 在“函数服务”页面上方,选择期望开启调试模式函数的地域。并在页面中单击期望开启调试模式的函数名,进入该函数的详情页面。
  3. 在“函数管理”页面中,选择函数代码 > 远程调试,并单击开启调试模式。如下图所示:
  4. 在弹出窗口中单击确认,即可完成调试模式的开启。如下图所示:

调试步骤

  1. 开启调试模式 后,函数更新后会自动启动调试。
    注意:

    若调试模式已开启,当您再次进入调试界面时,则需手动选择启动调试

  2. 待加载完成后,页面将自动展示入口文件。若要打开任意您需要的文件,可使用快捷键 Cmd + P(Mac)或 Ctrl + P(Windows)。
  3. 您可根据需要设置断点,单击测试即可根据测试模板触发测试。如下图所示:
    说明:

    更多关于调试工具的内容,可查阅 Chrome DevTools。

关闭调试模式

  1. 在“函数管理”页面中,选择函数代码 > 远程调试
  2. 关闭开启调试模式按钮,即可关闭调试模式,函数配置将恢复。
    注意:

    在调试页面修改代码不会同步到云端。如果您需要保存更改的代码,请保存并使用代码在线编辑功能。

常见问题

  • 由于网络、代码异常等情况可能造成 inspector 断开连接,当出现诸如下图情形时,需要您点击重启调试重新连接。
  • 若您的函数运行正常,但在调试模式遇到 Out Of Memory 错误,您需要调大函数的内存配置,以解决开启调试模式时函数所需内存增加导致内存不足的问题。
目录