云函数URL化路径必须以/开头，且需显式设置Content-Type为application/json，event.isBase64Encoded需判断解码，云对象URL化需HBuilderX 3.5.2+并手动启用HTTP访问。
云函数URL化配置路径必须以/开头
在uniCloud控制台里点进云函数详情页，找到「URL化」设置项，填的路径比如/upload或/push/send，开头那个/不能省——漏掉就直接 404，控制台也不会报错提示，只默默不生效。
填完保存后，实际访问时会自动补全完整地址，例如你的服务空间 ID 是 123abc，路径设为 /upload，最终 URL 就是 https://123abc.bspapp.com/upload（腾讯云）或 https://123abc.aliyuncs.com/upload（阿里云），不用手动拼接函数名。
- 路径支持嵌套，比如设成
/api/v1/user，那么/api/v1/user/profile和/api/v1/user/avatar都会路由到这个云函数 -
event.path在函数内可用，用来区分子路径，避免写一堆重复函数 - 路径不支持通配符（如
/user/*），所有匹配靠代码里判断event.path
客户端用uni.request调用要注意Content-Type
默认情况下，uni.request 发送 JSON 数据时不会自动带 Content-Type: application/json 头，而云函数解析 event.body 依赖这个头来决定是否直接 JSON.parse。没设的话，event.body 就是原始字符串，强行 JSON.parse 会报 SyntaxError: Unexpected token o in JSON at position 1 这类错误。
正确写法必须显式声明：
uni.request({
url: 'https://xxx.bspapp.com/upload',
method: 'POST',
header: {
'Content-Type': 'application/json'
},
data: { fileBase64: 'data:image/png;base64,...', name: 'avatar.png' }
})
- 如果传的是 base64 字符串且没加头，云函数里得先做
Buffer.from(event.body, 'base64').toString()，很绕 - H5 端有时会因跨域被拦截，需在云函数返回头里加
Access-Control-Allow-Origin（uniCloud 默认已配，但自定义响应时可能覆盖） - 小程序端无需担心跨域，但注意
uni.request不支持直接传File对象，必须转 base64 或用uploadFile
event.isBase64Encoded 判断不能省
当客户端上传图片等二进制数据（尤其 base64 格式），uniCloud 会自动对 event.body 做 base64 编码并置 event.isBase64Encoded = true。如果你的云函数既收 JSON 又收 base64，不判这个字段就容易崩。
标准处理模板：
exports.main = async (event) => {
let body = event.body;
if (event.isBase64Encoded) {
body = Buffer.from(body, 'base64').toString();
}
const data = JSON.parse(body);
// 后续逻辑
}
- 即使你只打算收 JSON，也建议加上这个判断——某些平台（如 Postman 模拟）可能误触发 base64 编码
- 别用
try/catch包整个JSON.parse来“兜底”，那会掩盖真实问题，比如前端传了空字符串或 null - 阿里云和腾讯云都遵循这个字段规范，行为一致，不用条件编译
云对象 URL 化需要 HBuilderX 3.5.2+ 且单独开启
云函数从上线就支持 URL 化，但云对象（uniCloud.database 的集合直连能力）的 URL 化是后来加的，且必须满足两个硬性条件：HBuilderX 版本 ≥ 3.5.2，且在云对象配置页手动勾选「启用 HTTP 访问」。
不满足任一条件，控制台里根本看不到云对象的 URL 化设置入口，也不会生成可访问路径。
- 升级 HBuilderX 后，右键云对象 → 「更多」→ 「配置」，才能看到开关
- 云对象 URL 化后路径规则和云函数一样，但权限控制更严格——必须在云对象的「安全规则」里明确放行对应 HTTP 方法（GET/POST/PUT/DELETE）
- 云对象 URL 化不支持
event.path路由，每个云对象只能绑定一个固定路径，不像云函数能靠路径前缀复用逻辑
