unicloud云数据库不支持sql join，但可通过jql在云函数中调用get({jql: true})实现联表查询，本质是mongodb $lookup 聚合操作；前端直调不识别jql，且必须配置正确db schema外键、同服务空间、字段名严格匹配，否则报错或返回空。
uniCloud云数据库不支持SQL JOIN，但能用JQL做联表查询
uniCloud的云数据库底层是MongoDB，没有传统SQL的JOIN语法，也不能跨集合执行事务或外键约束。所谓“联表”，实际是通过JQL（JSON Query Language）在get()时用$lookup聚合管道模拟——但它只在云函数内有效，前端直调uniCloud.database().collection().get()不识别JQL语法。
常见错误现象：permission denied、返回空数组、errCode: 400且提示unknown operator: $lookup——本质是把JQL写在了前端，或没在云函数里启用聚合查询。
- JQL必须写在云函数的
collection.where().get()中，且需显式传{ jql: true }参数 -
$lookup只能查同服务空间下的其他集合，不能跨空间、不能查外部MySQL - 被关联集合（如
user）必须已存在，且字段名要和localField/foreignField完全一致（区分大小写） - 联查结果默认不展开嵌套文档，需配合
$addFields和$arrayElemAt提取单条数据
云函数里写JQL联表查询的正确姿势
直接在云函数exports.main里调db.collection('articles').where(...).get({ jql: true })，其中where条件可含$lookup。别用require('mongodb')或手动拼聚合管道——uniCloud会自动转换JQL为MongoDB原生命令。
示例：查文章列表并带上作者昵称
const db = uniCloud.database()
exports.main = async (event, context) => {
return await db.collection('articles')
.where({
$lookup: {
from: 'user',
localField: 'user_id',
foreignField: '_id',
as: 'author'
}
})
.get({ jql: true })
}
注意：as: 'author'生成的是数组（哪怕只匹配一条），前端取值得用res.result[0].author[0].nickname；若想扁平化，得在云函数里加$addFields和$arrayElemAt，但JQL不支持这些操作符，此时必须切回原生聚合写法（见下一条）。
需要深度联表或字段计算？改用aggregate()原生聚合
当JQL不够用（比如要$sum统计评论数、$unwind展开数组、多层$lookup嵌套），就得放弃JQL，改用collection.aggregate()。它支持完整MongoDB聚合语法，但必须在云函数里写，且不能在前端调用。
-
aggregate()返回的是游标，必须链式调.end()才能执行，否则没结果 - 字段名带点号（如
author.nickname）必须用$前缀："author.nickname"→"$author.nickname" -
$lookup后若要取子字段，得接$unwind，否则author仍是数组 - 性能敏感场景慎用多层
$lookup，云数据库对聚合复杂度有限制，超时会报errCode: 500
示例：查文章+作者+评论数
const db = uniCloud.database()
exports.main = async (event, context) => {
const res = await db.collection('articles')
.aggregate()
.lookup({
from: 'user',
localField: 'user_id',
foreignField: '_id',
as: 'author'
})
.unwind('$author')
.lookup({
from: 'comments',
localField: '_id',
foreignField: 'article_id',
as: 'commentList'
})
.addFields({
commentCount: { $size: '$commentList' }
})
.project({
'author.nickname': 1,
'commentCount': 1,
title: 1,
_id: 1
})
.end()
return res
}
前端拿到联表数据后怎么安全渲染
联表结果里字段是嵌套结构，直接v-for遍历时容易因author为空数组导致author[0].nickname报错。别依赖后端永远返回完整数据——云函数可能因权限或网络失败漏掉$lookup结果。
- 前端一律用可选链
{{ item.author?.[0]?.nickname }}，避免渲染崩溃 - 如果联查字段用于排序或筛选，必须在云函数里完成（如
.sort({ 'author.nickname': 1 })），前端sort无法处理嵌套字段 - 真机调试时微信小程序可能因
author字段含特殊字符（如emoji）触发JSON序列化异常，建议云函数里用JSON.stringify()再JSON.parse()清洗一遍 - H5端若开本地调试，确保
manifest.json里勾选「H5 使用本地云函数」，否则JQL会被浏览器CORS拦截，表现为net::ERR_CONNECTION_REFUSED
真正麻烦的不是语法，而是联表后权限规则得重配：比如user集合的read权限若设为"auth.uid != null"，那$lookup时云函数以系统身份查user，权限校验会失败——必须把user的read权限改成true或明确允许云函数上下文访问。
