uniCloud云数据库不支持SQL JOIN，前端无法用where().get()跨表查询，必须通过服务端aggregate() + $lookup实现关联，且需严格遵循MongoDB语法、字段类型匹配及索引优化。
uniCloud 的云数据库不支持 SQL 式 JOIN，但能用 aggregate() + $lookup 实现等效的多表关联聚合——前提是必须用云对象或云函数，且聚合管道写法要严格符合 MongoDB 语法。
为什么不能直接在前端用 db.collection().where().get() 做联表
云数据库的简单查询（where、get）只作用于单集合，不解析外键也不跨集合查。你写 db.collection('user').where({ 'order.status': 'paid' }).get() 会直接报错或静默忽略嵌套字段——因为 order 根本不是 user 表里的字段，更不是数据库原生支持的关联语法。
常见错误现象：TypeError: Cannot read property 'status' of undefined 或返回空数组但没报错，其实是查询条件被忽略。
- 前端直接调用
get()只能查单表，连$lookup都不认 -
$lookup必须出现在聚合管道（aggregate()）里，且只能在服务端执行（云函数 / 云对象） - 云数据库的聚合操作不支持对系统集合（如
uni-id-users）做$lookup，这是硬限制
$lookup 的参数必须一一对应主副表字段
字段名拼错、类型不一致、大小写差异都会导致关联结果为空数组。比如主表字段是 user_id，副表却是 userId，$lookup 就不会匹配任何记录。
-
from：填目标集合名（字符串），不能带空格或特殊字符，例如'order'而不是'orders'（如果实际集合名是order） -
localField：主集合中用于关联的字段名，必须存在且类型与foreignField一致（都为 string 或都为 ObjectId） -
foreignField：副集合中用于匹配的字段名，注意它不是“副表主键”，而是和localField对应的外键字段 -
as：输出字段名，结果会以数组形式挂载到每条主表记录下，例如as: 'orders'→ 每个用户对象多一个orders: []字段
示例（正确）：
lookup({
from: 'order',
localField: '_id',
foreignField: 'user_id',
as: 'orders'
})
示例（错误）：foreignField: 'user_id_str'（如果副表存的是字符串 ID，但主表 _id 是 ObjectId，类型不匹配）
多个副表关联要用多个 $lookup 阶段，顺序不能颠倒
一个聚合管道可以链式调用多次 lookup()，但每次都要独立配置参数，且后续阶段（如 project）才能引用前一步 as 出来的字段名。
- 先查主表，再
lookup副表 A，再lookup副表 B —— 不能反过来 - 如果副表 B 的关联字段依赖副表 A 的结果（比如 B 关联 A 的 ID），那就得用
lookup嵌套 pipeline，不是简单字段映射 - 性能影响：每个
$lookup都是一次集合扫描，副表数据量大时响应明显变慢；建议副表加foreignField索引
两个副表示例（主表 main_table，副表 sub_table1 和 sub_table2）：
aggregate()
.match({ _id: event.id })
.lookup({
from: 'sub_table1',
localField: '_id',
foreignField: 'main_id',
as: 'sub1'
})
.lookup({
from: 'sub_table2',
localField: '_id',
foreignField: 'main_record_id',
as: 'sub2'
})
.end()
云对象比云函数更适合封装联表逻辑
云对象（.obj.js）天然支持方法导出和参数校验，调用时自动序列化/反序列化，比云函数更贴近“接口”语义；而云函数需手动解析 event，容易漏判空值或类型错误。
- 云对象方法名即 API 名，前端调用
userOrder.getUserWithOrders('xxx')比callFunction({ name: 'get-user-orders', data: { id: 'xxx' } })更直观 - 云对象内部可复用
db.command.aggregate，支持$project、$unwind等高级操作，云函数也能做，但结构松散 - 部署时云对象自动注册，无需额外配置；云函数若没上传或名字拼错，前端调用直接报
Function not found
容易被忽略的一点：聚合结果中的 data 是数组，即使只 match 到一条主记录，也要取 res.data[0]；而云对象返回的 res.data 是整个聚合结果数组，前端别误以为是单个对象。
