MongoDB在$project阶段字段名重复会报错，因输出文档不允许同名字段；常见于重构时手误，如同时定义"tags": 1和"tags": {"$filter": {...}}，或重复调用Spring Data的.and("field")；安全做法是避免重复声明，用$REMOVE条件排除、显式重命名或仅保留新定义。
为什么$project里字段名重复会报错
当 $project 阶段中同一个字段被多次赋值（比如既用 "name": 1 又用 "name": "$fullName"），MongoDB 会直接报错：FieldPath 'name' is already defined。这不是警告，是硬性拒绝执行——因为输出文档里不能有两个同名字段。
$project字段定义冲突的常见写法
这类错误多出现在重构或拼接管道时手误，尤其容易在以下场景发生：
- 先用
"tags": 1包含整个数组，后面又写"tags": {"$filter": {...}}覆盖它 - 用
"_id": 0排除 _id，但同时又写"_id": "$user_id" - 复制粘贴多个
$project阶段后没清理冗余字段，导致同一字段在不同位置重复出现 - 在 Spring Data MongoDB 中用
Aggregation.project()连续调用两次.and("status")，底层会生成重复键
如何安全地覆盖或条件排除字段
想“替换”字段值，或按条件去掉某个字段，不能靠后写覆盖前写，得用明确语法：
- 要重命名+保留原字段：用新字段名，如
"full_name": "$name"，别动"name": 1 - 要替换原字段：只写新定义，不保留旧字段，例如删掉
"name": 1，只留"name": "$fullName" - 要条件排除字段：用
$REMOVE，不是0或false。例如"description": {"$cond": {"if": {"$eq": ["$type", "draft"]}, "then": "$REMOVE", "else": "$description"}} - 想排除 _id 同时加新字段？必须用
"_id": 0开头，且后续所有字段都用1或表达式，不能混用0排他模式和显式包含
调试时怎么快速定位冲突字段
聚合管道越长，越难一眼看出哪两个阶段在争一个字段名。建议：
- 把
$project单独抽出来，在 mongosh 里用JSON.stringify(pipeline)看最终结构，搜重复 key - 用 Python 脚本预检：遍历每个
$project的 keys，用set判重，比人工扫快得多 - Spring Data 用户注意：
Aggregation.project().and(...).as("x")多次调用同名as会静默覆盖，但某些旧版本会抛异常，务必查你用的版本行为
字段名冲突不是数据问题，是管道定义的语法刚性约束——MongoDB 不做“后写胜出”的妥协，它要求你在写的时候就明确每个字段只出现一次。
