Agent Skills
返回列表
💻

CloudBase 云函数开发

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencentcloudbase-skills-cloud-functions。

技能介绍

要解决什么问题

在腾讯云开发(CloudBase)里,manageFunctions、网关暴露、scf_bootstrap 和函数日志往往混在一起:事件型函数写成 req/res、把 HTTP Access 当成 HTTP 云函数运行时,或让 HTTP 函数在无显式凭证时调用 @cloudbase/node-sdk,都会在部署后集中爆雷。本技能把「选型 → 编码契约 → 上线前检查」串成一条可执行路径。

技能如何工作

两种运行时模型需要一开始就定死:

  • 事件型云函数:exports.main = async (event, context) => {},面向 SDK 调用、定时器等事件驱动逻辑。
  • HTTP 云函数:独立进程监听 9000 端口,自带 scf_bootstrap 与依赖;默认用 Node 原生 http 模块,自行解析 URL 与 body,并处理 CORS。

改动或上线前,技能要求先读同目录兄弟技能里的交叉协议(Change Safety、Deployment Gate、敏感运行时数据保护)。HTTP 函数若访问 CloudBase 资源,必须走 ./references/http-function-credentials.md 的显式凭证方案,不能依赖事件型无密运行时路径。需要自定义系统库但仍保持 SCF 按请求扩缩时,可走 CustomImage HTTP 函数(TCR 镜像仍监听 9000),与监听注入 PORT 的长期云托管容器区分开。

实现细节通过 ./references.md 路由到专题文档;认证、微信支付生成函数、函数内 AI、平台 HTTP API 等会转到对应兄弟技能,避免在一个函数包里硬塞全部平台知识。

适用边界与注意点

  • 不要用本技能:纯 CloudRun 常驻服务、Web 登录页 UI、仅 SDK 就能完成的简单 CRUD(db.collection、app.rdb())、只消费官方平台 API 的客户端脚本。
  • 常见坑:创建后 runtime 不可改;HTTP 函数默认安全规则会拒绝匿名调用(EXCEED_AUTHORITY);Layer 名 common 跨环境会共享版本序列,应按 {layerName}_{envId} 命名;禁止把 x-cloudbase-context、process.env 等原样返回给客户端。
  • 仅有 Dockerfile 的无状态 HTTP 服务可优先 HTTP 云函数,不必默认上云托管;遗留 TCP/ORM 迁库才读 VPC 与 TCP 数据库例外文档。

使用场景

  • 小程序后端需要对外提供 REST 接口,要在 CloudBase 上新建 HTTP 云函数并处理 CORS 与 9000 端口监听契约
  • 定时任务或 SDK 触发业务逻辑,需要按事件型云函数编写 exports.main 并核对触发器与日志查询方式
  • 已有事件型函数要通过网关暴露 HTTP 路径,需区分 HTTP Access 配置与 HTTP 云函数运行时,避免改错代码形态
  • HTTP 函数内要调用云开发数据库或管理 API,需按凭证文档配置 Server API Key 或腾讯云密钥后再部署

适合人员

  • 用 CloudBase 做小程序/ Web 后端的工程师,要把部分逻辑从直调 SDK 迁到可独立部署的云函数
  • 负责 SCF 发布与网关的运维开发,需要在改 runtime、Layer 或安全规则前走完变更安全与上线门禁协议
  • 正在为 CloudBase 写 HTTP 接口的后端,不清楚事件型与 HTTP 型差异、反复踩 scf_bootstrap 与凭证配置问题
  • 维护含微信支付或集成中心生成函数的项目负责人,需要在函数运维与本技能、微信集成技能之间划清职责边界