↑

CloudBase 云函数开发指南v1.0.0

cloudbase-references-cloud-functions11 KB

面向 CloudBase 云函数开发与部署场景，覆盖 Event 函数（Node.js 事件驱动）与 HTTP 函数（多语言 Web 服务）两种类型的选型、编码、部署及运维。用户提及创建/更新云函数、配置 runtime、查看日志、实现 SSE/WebSocket、处理 scf_bootstrap 或 HTTP 访问配置时触发。

0 0 0 0 更新于 2026-10-28 18:24

免责声明：本站部分 Skill 来源于公开渠道，使用前请注意识别相关风险，内容版权归原作者所有，如 Skill 涉及版权问题，请在线反馈，核实后予以下架处理。

概述

本 Skill 聚焦 CloudBase 云函数全生命周期开发，解决 Event 函数与 HTTP 函数在选型、编码规范、部署流程及运维排查中的关键决策。针对 Event 函数，提供 SDK/定时触发场景下的 exports.main 标准写法、自动依赖安装机制及 runtime 锁定注意事项；针对 HTTP 函数，覆盖多语言（Node.js/Python/Go/Java）Web 服务搭建、端口 9000 监听、scf_bootstrap 引导配置、SSE 流式推送与 WebSocket 长连接实现。同时内置工具名映射表，帮助在 MCP 工具（manageFunctions/queryFunctions）与历史 CLI/旧版 API 之间安全切换，避免部署动作遗漏或 runtime 误选导致的环境重建。

技能包含

  • SKILL.md：技能主说明——函数类型判定、编码规范、部署流程、日志查询与工具映射
  • checklist.md：云函数执行检查清单，部署或 runtime 变更前必读

核心能力

  • 函数类型精准判定：根据触发方式（SDK/定时器 vs HTTP/REST/SSE/WebSocket）自动选择 Event 函数或 HTTP 函数模型，避免代码形态混用
  • Runtime 安全管控：明确 runtime 创建后不可变更的约束，提供 Node.js 版本选型建议与强制显式指定机制
  • 一键部署闭环：通过 manageFunctions 完成创建/更新/部署，禁止仅写文件不部署；支持 HTTP 函数 type="HTTP" 与 scf_bootstrap 配置
  • 日志分层查询：listFunctionLogs 概览配合 getFunctionLogDetail 基于 RequestId 定位单请求详情，注意 1 天时间窗口限制
  • 旧工具无缝迁移：历史工具名（createFunction/updateFunctionCode/getFunctionLogs 等）自动映射到统一入口 manageFunctions/queryFunctions
  • HTTP 高级协议支持：SSE 服务端推送、WebSocket 长连接、HTTP Access 网关配置的正确实现方式

应用场景

用户怎么说本技能做什么
"我要写一个定时触发的云函数，每天凌晨清理数据"判定为 Event 函数，使用 exports.main = async (event, context) => {} 形态，指定 Node.js runtime，通过 manageFunctions(action="createFunction") 创建并部署
"帮我搭一个 REST API，支持 POST 接收 JSON 并返回 200/400 状态码"判定为 HTTP 函数，使用 Express/Flask/Gin 等框架监听 9000 端口，配置 scf_bootstrap，显式添加 body-parser 中间件，确保所有分支发送响应
"云函数部署后调用超时，看不到详细报错"指导先用 queryFunctions(action="listFunctionLogs") 获取 RequestId，再用 getFunctionLogDetail 拉取完整堆栈；检查是否漏发 HTTP 响应或误选函数类型
"之前用的 createFunction 现在找不到了"映射到 manageFunctions(action="createFunction")，保持原 payload 结构不变，说明统一入口参数差异
"想在云函数里做 SSE 实时推送"确认为 HTTP 函数模型，提供长连接保持、响应头设置、scf_bootstrap 配置要点，禁止套用 Event 函数的事件驱动写法