云函数必须放在项目根目录下的cloudfunctions文件夹内，每个函数为独立子目录且入口文件为index.js（或index.ts）；调用需用uniCloud.callFunction并确保已初始化。
云函数写在哪？uniCloud 目录结构别搞错
unicloud 云函数必须放在项目根目录下的 cloudfunctions 文件夹里，且每个函数是一个独立子目录（比如 cloudfunctions/getuserinfo），不能直接放 js 文件。这个路径是硬编码的，改名或挪位置会导致本地调试失败、上传后找不到函数。
- 函数入口文件固定叫
index.js（或index.ts），不能用其他名字 -
cloudfunctions必须和uni-app的pages、static同级，不在src下 - 本地运行前要右键该函数目录 → “上传部署为云函数”，不是“上传所有”——否则可能覆盖线上已有逻辑
常见错误：在 HBuilderX 里新建了普通 JS 文件，没建目录结构，调用时提示 Function not found；或者把云函数写在 src/api/ 下，以为能直接 import，实际完全不生效。
怎么从 uni-app 页面调用？别漏掉 uniCloud.callFunction
前端调用云函数只用一个 API：uniCloud.callFunction，它不走 HTTP，而是走 uniCloud 内部通道，自动携带用户登录态（只要用了 uni.login 或 uniCloud.init 配置了 provider）。
- 必须先初始化：
uniCloud.init({ provider: 'tcb' })（阿里云填aliyun），否则调用直接报错uniCloud is not initialized -
name参数必须和云函数目录名完全一致（区分大小写），比如目录叫getUserInfo，就不能写成getuserinfo -
data是传给云函数event对象的内容，类型只能是 JSON 安全值（不能传函数、Date、undefined）
示例：
uniCloud.callFunction({
name: 'getUserInfo',
data: { userId: 'u123' }
}).then(res => {
console.log(res.result) // 注意是 res.result，不是 res.data
})云函数里怎么拿客户端传的数据？event 不是 req
云函数入口函数接收的是 event 对象，不是 Express 的 req。它结构简单：
-
event.data：前端callFunction传来的数据 -
event.userInfo：如果用户已登录，这里会有openid、uid等（需在uniCloud.init时开启 login） -
event.uniIdToken：仅当配置了 uni-id 且用户登录后才存在
容易踩的坑：
- 把
event.body当成 POST 数据去解，结果是undefined——云函数没有body字段 - 在云函数里用
require('http')或fetch模拟请求，却忘了阿里云/腾讯云环境默认禁用外网出方向（需在控制台开通白名单） - 返回值必须是可 JSON 序列化的对象，
return new Date()会变成null
本地调试总失败？检查这三件事
本地调试云函数不是“点一下就跑”，它依赖 HBuilderX 的云函数模拟器，很多失败其实和代码无关：
- 确保 HBuilderX 已登录 DCloud 账号，且项目已绑定云空间（右键项目 → “uniCloud” → “绑定云空间”）
- 云函数目录右键 → “本地运行”，不是“运行到浏览器”——后者根本不会启动云函数服务
- 控制台报
connect ECONNREFUSED 127.0.0.1:3000？说明模拟器没起来，关掉 HBuilderX 全部窗口再重开一次
另外，console.log 输出在 HBuilderX 底部 “uniCloud 日志” 面板，不在浏览器控制台；日志延迟半秒左右，别刚调用就刷新面板。
云函数的冷启动、超时限制（默认 10 秒）、内存上限（默认 256MB）这些在本地调试时几乎不体现，等上线后才突然暴露——尤其是做文件处理或数据库聚合查询时，本地跑得飞快，线上直接超时。
