赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 函数计算 FC 3.0
  4. 操作指南
  5. 代码开发
  6. Node.js
  7. 函数实例生命周期回调方法

函数实例生命周期回调方法

  • Node.js
  • 发布于 2025-04-16
  • 0 次阅读
文档编辑
文档编辑

当您实现并配置函数实例生命周期回调后,函数计算将在相关实例生命周期事件发生时调用对应的回调程序。当前,Node.js运行时支持Initializer和PreStop函数实例生命周期回调。

注意事项

函数实例生命周期回调程序与正常调用请求计费规则一致,但其执行日志只能在函数日志、实时日志或高级日志中查询,调用请求列表不会展示回调程序日志。具体操作,请参见查看实例生命周期回调函数日志。

Initializer回调

初始化回调程序(Initializer回调)在函数实例启动成功之后,运行请求处理程序(Handler)之前执行。函数计算保证在一个实例生命周期内,成功且最多成功执行一次Initializer回调。例如,您的Initializer回调第一次执行失败后系统会重试,直到成功为止,然后再执行您的请求处理程序。

Initializer回调只有一个context输入参数,一个最简单的Initializer回调如下所示。

ES模块

说明

此示例仅支持运行在Node.js 18及以上版本的运行时环境。

export const initialize = async (context) => {
  console.log('initializer');
  return "";
}

CommonJS模块

exports.initialize = function(context, callback) {
  console.log('initializer');
  callback(null, "");
};   

initialize是Initializer回调方法名,需要与您在函数计算控制台配置的Initializer 回调程序一致。例如,您为函数配置的Initializer 回调程序为index.initialize,那么函数计算在配置Initializer属性后会去加载index.js中定义的initialize方法。

方法签名

  • 输入参数只有context,为您的FC函数调用提供在调用时的运行上下文信息。

  • 无返回值,需要在代码中主动调用return或callback来结束函数。

PreStop回调

预停止回调程序(PreStop回调)在函数实例销毁前执行,方法签名同Initializer回调。

一个最简单的preStop程序如下所示。

ES模块

说明

此示例仅支持运行在Node.js 18及以上版本的运行时环境。

export const preStop = async (context) => {
  console.log('preStop');
  return "";
}

CommonJS模块

module.exports.preStop = function(context, callback){
  console.log('preStop');
  callback(null, "");
}

配置生命周期回调函数

通过控制台配置

您可以在函数计算控制台的FC函数配置中,配置Initializer 回调程序和PreStop 回调程序。具体操作步骤,请参见配置实例生命周期。回调格式为[文件名.方法名],例如:

  • Initializer 回调程序设置为index.initialize,表示index.js文件中的initialize方法。

  • PreStop 回调程序设置为index.preStop,表示index.js文件中的preStop方法。

db-node.js-lifecycle

通过Serverless Devs工具配置

如果使用Serverless Devs工具,需要在s.yaml配置文件中添加Initializer 回调程序和PreStop 回调程序。

  • Initializer回调配置

    在props配置下添加instanceLifecycleConfig.initializer字段,包括handler和timeout两个字段。

  • PreStop回调配置

    在props配置下添加instanceLifecycleConfig.preStop字段,包括handler和timeout两个字段。

具体的示例如下所示。

edition: 3.0.0
name: hello-world-app
access: default         #  密钥别名

resources:
  hello_world:
    component: fc3 # 组件名称,Serverless Devs 工具本身类似于一种游戏机,不具备具体的业务能力,组件类似于游戏卡,用户通过向游戏机中插入不同的游戏卡实现不同的功能,即通过使用不同的组件实现不同的具体业务能力
    # actions:       # 自定义执行逻辑,关于actions 的使用,可以参考:https://docs.serverless-devs.com/serverless-devs/yaml#%E8%A1%8C%E4%B8%BA%E6%8F%8F%E8%BF%B0actions
    props:
      region: cn-hangzhou # 关于变量的使用方法,可以参考:https://docs.serverless-devs.com/serverless-devs/yaml#%E5%8F%98%E9%87%8F%E8%B5%8B%E5%80%BC
      functionName: nodejs-fc-hooks
      description: "Node.js lifecycle hooks by serverless devs"
      runtime: nodejs20
      code: ./code
      handler: index.handler
      memorySize: 128
      timeout: 30
      instanceLifecycleConfig:
        preStop:
          handler: index.preStop
          timeout: 3
        initializer:
          handler: index.initialize
          timeout: 3
      internetAccess: true
      logConfig: auto

关于Serverless Devs的YAML配置规范,请参见Serverless Devs常用命令。

查看实例生命周期回调函数日志

您可以通过函数日志功能查看回调函数日志。

  1. 登录函数计算控制台,在左侧导航栏,单击函数。

  2. 在顶部菜单栏,选择地域,然后在函数页面,单击目标函数。

  3. 在函数详情页面,选择测试页签,单击测试函数,然后选择日志 > 函数日志。

    在函数日志页签,您可以查看函数的调用日志和Initializer回调日志,示例如下。

    2023-09-06 11:18:10FC Initialize Start RequestId: 1-64f7ef72-64caf1ff0046194d9a26bbd7
    2023-09-06 11:18:10load code for handler:index.initialize
    2023-09-06 11:18:102023-09-06 11:18:10 1-64f7ef72-64caf1ff0046194d9a26bbd7 [verbose] initializer
    2023-09-06 11:18:10FC Initialize End RequestId: 1-64f7ef72-64caf1ff0046194d9a26bbd7
    2023-09-06 11:18:10FC Invoke Start RequestId: 1-64f7ef72-64caf1ff0046194d9a26bbd7
    2023-09-06 11:18:10load code for handler:index.handler
    2023-09-06 11:18:10FC Invoke End RequestId: 1-64f7ef72-64caf1ff0046194d9a26bbd7

    因为每个函数实例会缓存一段时间,不会马上销毁,因此不能立即查看PreStop回调日志。如需快速触发PreStop回调,可更新函数配置或者函数代码。更新完成后,再次查看函数日志,您可以查看PreStop回调日志。示例如下。

    2023-09-06 11:08:10FC PreStop Start RequestId: 944bca62-b209-47a1-9e48-2723647bce0a
    2023-09-06 11:08:10load code for handler:index.preStop
    2023-09-06 11:08:102023-09-06 11:08:10 944bca62-b209-47a1-9e48-2723647bce0a [verbose] preStop
    2023-09-06 11:08:10FC PreStop End RequestId: 944bca62-b209-47a1-9e48-2723647bce0a

示例程序

函数计算为您提供了使用Initializer回调和PreStop回调的MySQL示例程序。在本示例中,Initializer回调函数用于从环境变量中获取MySQL数据库配置,创建MySQL连接并测试连通性,PreStop回调函数负责关闭MySQL连接。

详细信息,请参见nodejs14-mysql。

相关文档

更多关于函数实例生命周期回调方法的说明,请参见配置实例生命周期。

相关文章

请求处理程序(Handler) 2025-04-16 14:38

您可以使用Node.js请求处理程序响应接收到的事件并执行相应的业务逻辑。本文介绍Node.js请求处理程序的相关概念、结构特点和示例。 什么是请求处理程序

上下文 2025-04-16 14:38

本文介绍在函数计算中使用Node.js运行时开发代码时,所涉及的Context(上下文)的相关概念。

部署代码包 2025-04-16 14:38

本文以安装第三方依赖emoji为例,介绍如何为您的Node.js代码安装依赖,打包并部署代码至函数计算。

日志 2025-04-16 14:38

您可以在Node.js运行环境中打印和查看日志,通过日志快速定位问题或分析日志了解函数执行过程和耗时等,提升系统的可靠性和稳定性。 打印日志 函数往标准输出stdout打印的日志内容会被收集到创建服务时指定的Logstore中,您可以使用如下几种方式打印日志至标准输

错误处理 2025-04-16 14:38

本文介绍Node.js运行环境的错误处理相关内容。 错误类型 捕获异常 如果函数在执行过程中抛出异常,函数计算会捕获到错误,并生成一个包含错误信息、类型和堆栈信息的JSON格式的数据,示例如下所示。

函数实例生命周期回调方法 2025-04-16 14:38

当您实现并配置函数实例生命周期回调后,函数计算将在相关实例生命周期事件发生时调用对应的回调程序。当前,Node.js运行时支持Initializer和PreStop函数实例生命周期回调。

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号