输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
指南
指南应用服务Cloud Foundation Kit（云开发服务）云函数开发云函数调用函数

调用函数

更新时间: 2026-09-09 06:54
本文导读

约束与限制

支持Phone、Tablet设备。并且从5.1.0(18)版本开始，新增支持Wearable设备；从5.1.1(19)版本开始，新增支持TV设备；从6.1.0(23)版本开始，新增支持PC/2in1设备。

设置云函数配置项

在“entry/src/main/module.json5”文件中添加网络权限。

收起
自动换行
深色代码主题
复制
  1. "requestPermissions": [
  2.   {
  3.     "name": "ohos.permission.INTERNET"
  4.   }
  5. ]

查询函数名和版本

在函数的触发器页面点击“HTTP触发器”，查看“触发URL”的后缀，获取触发器的标识，格式为“函数名-版本号”。如下图所示，“myhandlerxxxx-$latest”即为HTTP触发器标识，其中“myhandlerxxxx”为函数名，“$latest”为版本号。

在应用中调用函数

  1. 导入相关模块。

    收起
    自动换行
    深色代码主题
    复制
    1. import { cloudFunction } from '@kit.CloudFoundationKit';
    2. import { BusinessError } from '@kit.BasicServicesKit';
    3. import { hilog } from '@kit.PerformanceAnalysisKit';
    FunctionPage.ets

  2. 调用call()方法设置函数，在方法中传入函数名称，返回调用结果。

    • （可选）通过设置timeout属性对云函数设置超时时长，单位为ms。
    • （可选）通过设置version属性对云函数设置函数版本号，默认为最新版本'$latest'。
    • （可选）如果函数有入参，可以将data参数转化为JSON对象或JSON字符串传入，如果没有参数则不传。

    使用Promise异步回调：

    收起
    自动换行
    深色代码主题
    复制
    1. cloudFunction.call({
    2.   name: 'sort', // sort需替换为实际的函数名
    3.   version: '$latest', // 如果不传入版本号，默认为“$latest”。
    4.   timeout: 10 * 1000, // 单位为ms，默认为70*1000ms。
    5.   data: {
    6.     // data为函数请求体
    7.     param1: 'val1',
    8.     param2: 'val2'
    9.   }
    10. }).then((res: cloudFunction.FunctionResult) => {
    11.   hilog.info(0x0000, 'function', `Succeeded in calling the function, result: ${JSON.stringify(res.result)}`);
    12. }).catch((err: BusinessError) => {
    13.   hilog.error(0x0000, 'function', `Failed to call function , code: ${err.code}, message: ${err.message}`);
    14. });
    FunctionPage.ets

    或者，使用callback异步回调：

    收起
    自动换行
    深色代码主题
    复制
    1. cloudFunction.call({
    2.   name: 'sort-id', // sort-id需替换为实际的函数名
    3.   version: '$latest', // 如果不传入版本号，默认为“$latest”。
    4.   timeout: 10 * 1000, // 单位为ms，默认为70*1000ms。
    5.   data: {
    6.     // data为函数请求体
    7.     param1: 'val1',
    8.     param2: 'val2'
    9.   }
    10. }, (err: BusinessError, res: cloudFunction.FunctionResult) => {
    11.   hilog.info(0x0000, 'function', `Succeeded in calling the function, result: ${JSON.stringify(res.result)}`);
    12.   if (err) {
    13.     hilog.error(0x0000, 'function', `Failed to call function , code: ${err.code}, message: ${err.message}`);
    14.     return;
    15.   }
    16. });
    FunctionPage.ets
测试函数
（可选）通过端云一体化开发工程调试本地云函数
相关推荐
文档调用本地云函数
文档设置云存储配置项
文档Node.js
文档cloudFunction (云函数模块)
文档通过云函数扩展
文档开发函数
文档创建并配置函数
文档在端侧调用云函数
文档通过配置Configuration优化传输性能
文档初始化数据库访问
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词