MongoDB禁止字段名含“$”或“.”，因BSON规范底层限制；但字段值含这些字符可在$project中安全使用，需区分路径引用（不转义）与字面量（如“$price”需双反斜杠转义）。
直接说结论：MongoDB 不允许字段名（key）中包含 $ 或 .，哪怕是在 $project 的表达式里用字符串引用（如 "$field"）也无法绕过这个硬性限制；但如果你指的是「值中含特殊字符的字段」被用于 $project 表达式计算（比如 $substr、$concat），那完全可行——只是得注意转义和语法层级。
为什么不能用 $ 或 . 作为键名
MongoDB 的 BSON 规范从底层禁止字段名含 $ 和 .。这不是聚合阶段的限制，而是整个文档结构的约束。即使你试图在 $project 中写：{"user.name": "$user_name"}，MongoDB 会直接报错：FieldPath field names may not contain '.'。同理，{"$id": 1} 会被拒绝：FieldPath field names may not start with '$'。
- 错误示例：
db.coll.aggregate([{$project: {"user.name": "$name"}}])→ 报错 - 正确替代：改用下划线或驼峰，如
"user_name"或"userName" - 已有坏数据？必须先用
$rename或 update 操作修复字段名，再进聚合管道
$project 中引用含特殊字符的字段值（不是键名）
这里的关键是区分「字段名」和「字段值」。如果字段值本身含 $、.、 等（比如日志文本、用户输入），它们在 $project 表达式中可安全使用，但需注意：
- 字符串字面量中出现
$要写成"$"（例如：{$substr: ["$price", 0, 5]}） - 字段路径引用（如
"$desc"）中的$是语法符号，不表示字面量，无需转义 - 若字段值含反斜杠
，存入时已需双写为\，读取后在表达式中按原值参与运算 - 示例：对字段
raw_input值为"cost: $29.99"做截取：{$project: {snippet: {$substr: ["$raw_input", 6, 7]}}}→ 输出"$29.99"
Java Driver 中构造含特殊字符值的 $project 表达式
Java 里用 Document 构建聚合阶段时，重点不是“键名能否含 $”，而是「值数组里的字符串是否要转义」。比如用 $substr 截取带 $ 的字段值：
- 错误写法（未转义字面量）：
Arrays.asList("$_id", 0, -1)—— 这没问题，因为"$_id"是字段路径，不是字面量 - 正确写法（字面量含
$）：Arrays.asList("$total", 0, 5)—— 注意开头的 - 更安全的方式：用
$literal包裹字面量：new Document("$literal", "$total") - 别漏掉：Java 字符串本身也需转义反斜杠，所以
"\$total"才对应 JSON 中的"$total"
真正容易被忽略的是：字段名非法是服务端校验，发生在解析阶段；而字段值里的特殊字符是否生效，取决于它出现在表达式哪一层——路径引用层不转义，字面量层必须转义。很多人卡在 Java 字符串 + JSON 序列化 + MongoDB 解析三层转义上，结果不是少一个 就是多一个。
