collection.where().remove() 必须在云函数中调用才可靠，因前端直连无权限且环境受限；条件需用command.and()等安全写法，大数量删除须分批处理并检查schema上传、provider匹配和字段名大小写。
直接用 collection.where().remove() 就能批量删，但不加限制会误删、超时、权限报错——关键在条件写法、云函数封装和权限配置。
为什么 collection.where().remove() 在云函数里才可靠
前端直连调用 collection.where().remove() 大概率失败，不是语法错，而是权限和执行环境问题：
- 前端默认无
remove权限，即使 schema 里开了"remove": true，也可能因未上传或字段索引缺失被拦截 - H5 端若没配
"h5": { "useUniCloud": true }，uniCloud.database()根本不可用 - 云函数运行在服务端，权限由云空间身份决定，不受前端 schema 限制，适合做高危操作
所以批量删除必须走云函数，前端只负责传参、触发 uniCloud.callFunction()。
where() 条件怎么写才安全不漏删
条件写错会导致删多、删少、甚至删空整个集合。常见陷阱：
- 用
{ status: 0 }没问题，但用{ status: '0' }（字符串）可能匹配不到——数据库里存的是数字类型 - 想删“创建时间早于 7 天前”的数据，别写
where({ createTime: { $lt: Date.now() - 604800000 } })，JQL 不认$lt，得用command.lt() - 复合条件必须用
command.and()或command.or()显式包裹，比如where(command.and({ status: 0 }, { type: 'temp' })) - 慎用正则或模糊查询（如
command.regex()）删大量数据，容易超时或命中未建索引字段
示例（安全写法）：
const db = uniCloud.database()
const _ = db.command
exports.main = async (event, context) => {
const res = await db.collection('logs')
.where(command.and(
{ status: 0 },
{ createTime: _.lt(Date.now() - 7 * 24 * 60 * 60 * 1000) }
))
.remove()
return { deleted: res.deleted }
}
大数量删除为什么会超时？怎么分批
UniCloud 云函数默认超时 5 秒，单次 remove() 若匹配上万条，大概率超时并只删掉一部分。
- 阿里云版暂不支持
limit()配合remove()，即.where(...).limit(100).remove()会忽略limit，仍尝试删全部匹配项 - 正确做法是：先
count()总数 → 循环调用云函数，每次where().skip().limit().get()拿一批_id→ 再用doc(id).remove()逐个删（或拼成doc([id1,id2,...]).remove()批量删） - 更稳妥的是在云函数内用
db.collection().aggregate()+deleteMany（仅腾讯云支持），但需注意事务兼容性
简单分批逻辑示意（前端控制循环）：
// 前端调用时传 offset 和 limit
uniCloud.callFunction({
name: 'batchDeleteLogs',
data: { offset: 0, limit: 100 }
})
云函数内查 ID 列表再删，比直接 where().remove() 更可控。
删完没反应？检查这三处最容易忽略的地方
返回 { deleted: 0 } 或报 permission denied，往往不是代码问题：
-
schema.json里该集合的"remove"权限为false，且没右键「上传 DB Schema」——改完文件必须手动上传才生效 - 云函数用的是阿里云空间，但代码里写了
uniCloud.database({ provider: 'tencent' })，provider 不匹配导致初始化失败 - 数据库字段名大小写写错，比如实际是
createTime，你写了createtime，where()查不到任何数据，自然删 0 条
真正麻烦的不是“怎么删”，而是删之前没确认条件是否真能命中目标数据——建议删前先跑一遍 where().count() 或 where().field({ _id: true }).get() 看看返回哪些 ID。
