将unicloud云函数冷启动压至200ms内，需聚焦初始化阶段优化：按需加载依赖、延迟非必要初始化、启用函数预热、复用数据库连接实例，并确保_id类型一致、索引合理、h5开启本地调试。
云函数冷启动延迟高，怎么压到 200ms 内
uniCloud 云函数首次调用慢，本质是容器初始化耗时。阿里云/腾讯云底层虽有预热机制，但默认不开启，导致 exports.main 执行前就卡在加载 Node.js 环境、读取依赖、初始化数据库连接上。
实操建议：
- 在云函数入口文件顶部加
console.time('init')，结尾加console.timeEnd('init')，确认耗时是否真在初始化阶段（而非业务逻辑） - 避免在
exports.main外部执行耗时操作：比如require('./heavy-module')放在函数体内按需加载，而不是顶部const x = require(...) - 数据库连接复用：把
uniCloud.database()实例缓存在函数作用域外（非全局），但必须确保每次调用都用新collection().where().get()，不能复用 query 对象 - 阿里云空间可开启「函数预热」：进 uniCloud 控制台 → 服务空间 →「云函数」→ 找到对应函数 → 右上角「更多」→「开启预热」，设置 1–5 分钟间隔（注意：仅对高频函数有效，低频函数反而浪费资源）
数据库查询慢，get() 卡住超过 800ms 怎么办
不是网络问题，而是查询没走索引或权限配置触发了全表扫描。uniCloud 数据库的 get() 默认不加索引，哪怕只查 where({ _id: 'xxx' })，如果字段类型不匹配（比如 _id 存的是字符串但传了数字），也会退化为遍历。
实操建议：
- 检查字段类型一致性：
where({ _id: 'abc123' })中的值必须是字符串；若存的是ObjectId，前端传参就得用new ObjectId('abc123')（仅限云函数内，前端 SDK 不支持） - 手动创建索引：进 uniCloud 控制台 → 数据库 → 表名 →「表结构」→「索引」→ 新建单字段索引（如
user_id、status），复合索引暂不支持 - 避免
where({ status: 'active', created_at: { $gt: xxx } })这类双条件查询不带索引，优先拆成单字段过滤 + 前端二次筛 - 大集合（>10w 条）慎用
skip()分页，改用游标分页：where({ _id: { $gt: lastId } }).limit(20)
callFunction 调用超时，是前端还是后端问题
90% 是前端配置或调用时机不对，不是云函数代码慢。常见错误是把 uniCloud.callFunction 写在 onLoad 里却没等 uniCloud.init 完成，或 H5 端没开本地调试开关。
实操建议：
- H5 端必须开启「使用本地云函数」：项目 manifest.json →「H5 配置」→ 勾选「H5 使用本地云函数」，否则走跨域请求，浏览器直接拦截
- 小程序端确保
uniCloud.init已执行：不要在App.vue的onLaunch里直接调用callFunction，先await uniCloud.init()或监听onInit回调 - 云函数返回数据别太大：单次响应 > 6MB 会被截断，且传输时间陡增；前端用
event.data接收时，若含 base64 图片，先压缩再上传 - 检查服务空间绑定状态：HBuilderX 右键项目 →「uniCloud」→「切换服务空间」，确认当前运行环境和服务空间一致（尤其多环境开发时）
云函数里调第三方 API 拖慢响应，怎么解耦
同步调用微信支付回调、短信发送这类外部接口，会把云函数执行时间拉长到秒级，极易超时（默认 10s，阿里云最低可设 1s）。这不是优化能解决的，必须异步化。
实操建议：
- 把第三方调用拆成两个函数：A 函数接收请求并写入中间表（如
task_queue），立即返回 success；B 函数用定时触发器每 30 秒扫一次表，批量处理 - 用
uniCloud.callFunction({ name: 'sendSms', type: 'async' })显式声明异步调用（仅阿里云支持），但注意：异步调用不返回结果，适合发通知类场景 - 敏感凭证（如短信密钥）绝不能硬编码在云函数里，统一放「环境变量」中（控制台 → 云函数 → 编辑 →「环境变量」），避免代码泄露
- 第三方 API 超时设为 3s 内：
uniCloud.httpclient.request({ timeout: 3000 })，防止一个失败请求拖垮整个函数
_id 类型传错、以及把耗时 IO 操作留在主流程里——这些点一错，所有性能优化都白搭。
