$regexFind 的 captures 为空是因为未启用捕获组或匹配失败；仅当正则含 () 且对应内容存在时，captures 才填充按序索引的子匹配字符串，非捕获组和命名组无效。
为什么 $regexFind 返回的 captures 是数组但经常为空？
因为 $regexFind 默认只匹配整个字符串是否符合模式，不启用捕获组；必须显式使用带括号的子表达式（()），且正则字面量中要加 g 标志（尽管实际只返回首次匹配）——但关键点是：只有子表达式匹配成功，captures 才有内容。常见错误是写成 /(abc)/ 却忘了输入字段里根本没出现 "abc"，或者用了 ^/$ 锚点导致局部文本无法匹配。
实操建议：
- 先在 JS 或 mongosh 里用
new RegExp('(...)', 'g').exec("test string")验证捕获逻辑 - 聚合中正则必须写成字面量形式：
/{pattern}/g，不能传字符串变量（否则captures永远为空） - 确保目标字段是字符串类型；若为
null或缺失，$regexFind返回null，访问.captures会报错
$regexFind 的 captures 数组索引怎么对应括号顺序？
和 JavaScript 正则完全一致：从左到右，每对未嵌套的 (...) 对应一个索引，captures[0] 是第一个 (...) 匹配的内容，captures[1] 是第二个，以此类推。注意非捕获组 (?:...) 不计入索引，命名捕获组 (?<name>...)</name> 在 $regexFind 中不被支持，会直接忽略名称、仅按位置存入 captures。
示例：对字段 url: "https://api.example.com/v2/users/123" 执行：
{
$regexFind: {
input: "$url",
regex: /https:\/\/api\.([^.]+)\.com\/v(\d+)\/(\w+)\/(\d+)/,
options: "g"
}
}
结果中 captures 为 ["example", "2", "users", "123"] —— 四个括号，严格按出现顺序。
如何安全提取 captures 并避免 undefined 报错？
聚合阶段不能直接写 $regexResult.captures.0，必须用 $arrayElemAt 或条件判断。最简健壮写法是结合 $cond + $isArray + $gt 判断长度：
{
$addFields: {
domain: {
$cond: {
if: { $and: [
{ $isArray: "$regexResult.captures" },
{ $gt: [{ $size: "$regexResult.captures" }, 0] }
]},
then: { $arrayElemAt: ["$regexResult.captures", 0] },
else: null
}
}
}
}
常见陷阱：
- 直接用
$regexResult.captures.0：若captures为null或不存在，整个字段变成undefined，后续阶段可能静默失败 - 忘记
options: "g"：某些 MongoDB 版本（如 4.2）下缺该选项会导致captures始终为空数组 - 在
$project中嵌套太深，比如{ a: { b: "$regexResult.captures.0" } }，一旦captures无效，a.b就是null而非报错，难调试
替代方案：什么时候该换用 $replaceAll 或 $split？
如果只是提取固定分隔符之间的内容（比如 URL 路径段、邮箱用户名），$regexFind 过重且易出错。$split + $arrayElemAt 更快更直观；若需替换后截取，$replaceAll（5.0+）配合 $substrCP 更稳。
例如提取邮箱前缀：
- 用正则：
$regexFind: { input: "$email", regex: /^([^@]+)/ }→ 取captures[0] - 更简单：
{ $arrayElemAt: [{ $split: ["$email", "@"] }, 0] }，无正则开销，不依赖捕获组逻辑
真正需要 $regexFind 的场景其实很窄：必须依赖上下文（如单词边界 \b）、可变长度断言（(? 不支持）、或多个并列捕获组同时提取。别为了“看起来高级”硬套正则。
