华为云 FunctionGraph 实战：触发器选型、冷启动治理、并发配额与可观测性避坑指南

前言

FunctionGraph 把"写好函数、上传、按事件触发"这件事做成了托管服务，免去了买服务器、装运行时和扩缩容的负担。真正容易踩坑的地方往往不在代码本身，而在触发器选型、冷启动、并发配额、超时重试和观测。本文按上线顺序整理常见问题，具体规格与参数以 FunctionGraph 官方文档和控制台为准。

一、触发器先想清楚，后改成本很高

• HTTP 触发器：适合对外 API、Webhook。注意鉴权（APIG 或函数级鉴权）、超时上限和请求体大小限制；高 QPS 场景要提前核算并发配额。
• 定时触发器（Cron）：适合批处理、对账、清理任务。Cron 表达式按北京时间还是 UTC 要以控制台说明为准，避免半夜跑错时区。
• 云服务事件触发器：OBS 上传、DIS 流、LTS 日志、SMN 通知等。要确认事件投递是至少一次还是恰好一次，并在函数里做幂等。
• 不要"一个函数干所有事"：触发方式不同，超时、并发和失败处理策略差异很大，拆开比硬塞进一个入口更稳。

二、冷启动：先度量，再治理

冷启动是函数从"没有实例"到"能处理第一个请求"的时间，常见于闲置后、新版本发布后或突发扩容时。治理顺序建议是：

• 用调用链路或日志里的"初始化耗时 / 执行耗时"分开看，确认瓶颈在下载依赖、初始化 SDK，还是业务逻辑本身；
• 减小部署包：去掉无用依赖，大文件放到 OBS 按需拉取；运行时初始化尽量懒加载；
• 把昂贵的连接建立（数据库连接池、SDK client）放到全局作用域复用，而不是每次调用都新建；
• 对延迟敏感的入口，评估预留实例（Reserved Instance）或定时预热，成本要和 SLA 一起算。

// Node.js 示意：把 client 放在全局，跨调用复用
const { ObsClient } = require('esdk-obs-nodejs');
let obs;
function getObs() {
  if (!obs) obs = new ObsClient({ /* 从环境变量读配置 */ });
  return obs;
}
exports.handler = async (event, context) => {
  const client = getObs();
  // ...
};

三、并发、配额与超时

• 单实例并发与函数总并发是两层概念：前者决定一个实例同时处理多少请求，后者是账号/函数的上限。突发流量打满配额时，新请求会被限流或排队，表现成偶发超时。
• 超时要略大于业务 P99，但不要盲目拉到上限：超时过长会占用并发配额，拖垮下游。异步场景优先"快速入队 + 后续处理"。
• 内存规格同时影响 CPU 配额：内存选太小，CPU 也跟着变慢，冷启动和执行都会变差。用压测找"时延-成本"平衡点，而不是默认最小值。

四、重试与幂等

事件触发和异步调用通常会有重试。如果函数不是幂等的，重试会写出重复订单、重复短信。落地建议：

• 用业务主键或事件 ID 做去重表 / 幂等键；
• 写操作优先"先写幂等记录，再做副作用"；
• 明确哪些错误可重试（网络抖动、限流），哪些不可重试（参数非法），避免无效重试烧配额；
• 对接 SMN、短信、支付等外部系统时，把"已发送"状态落到存储，重入时直接跳过。

五、网络与依赖云服务

• 函数默认出网能力、是否需要绑定 VPC 访问 RDS/DCS，以当前区域能力为准。绑 VPC 后冷启动和 ENI 准备时间可能增加，要单独压测。
• 访问华为云其他服务时，优先用委托（Agency）而不是把永久 AK/SK 写进代码或环境变量。
• 连接 RDS、DCS 时注意连接数：高并发函数 × 每实例连接数很容易打满数据库 max_connections，应用侧用短连接或连接池并限制单实例并发。

六、可观测性

• 打开函数日志，关键路径打结构化字段（requestId、业务单号、耗时）；
• 关注调用次数、错误率、时长、并发、限流次数；对 P99 时长和错误率设告警；
• 调用链（若已接入）把 APIG → 函数 → 下游串起来，冷启动和下游超时一眼能分清；
• 版本与别名：生产用别名指向稳定版本，灰度用流量分流，避免直接改 $LATEST。

七、上线前检查清单

• 触发器类型、鉴权、事件来源与幂等策略已确认；
• 超时、内存、并发配额按压测结果设置，并留有余量；
• 冷启动耗时可接受，或已配置预留/预热；
• 未在代码中硬编码密钥，使用委托或加密的环境变量；
• VPC、安全组、依赖服务连接数已验证；
• 日志、监控、告警、版本别名已就绪，做过一次失败重试演练。

结语

FunctionGraph 把弹性交给了平台，但触发方式、冷启动、并发和幂等仍然要业务侧设计到位。把上面几项逐条对照，大部分线上问题可以在发布前暴露。欢迎在评论区交流你们在 FunctionGraph 使用中的经验和问题。