MongoDB聚合投影报错：如何根据隐私条件控制user.phone字段显示

问题背景 #

你的MongoDB文档结构如下：

{
  "_id": "be9e9198-86ab-456e-97e1-f1039cb07b59",
  "isDeleted": false,
  "user": {
    "name": "john2",
    "surname": "doe2",
    "email": "123.abcd@gmail.com",
    "phone": "+012345678912",
    "age": 20,
    "gender": "male",
    "nationality": "smth",
    "universityMajor": "ENGINEERING",
    "preferences": null,
    "highPrivacy": false
  },
  "postings": [],
  "starredPostings": [],
  "user.timestamp": "xxx"
}

需求：当user.highPrivacy为false时返回user.phone字段，为true时排除该字段。

你尝试的聚合代码：

dbConnection.aggregate([
    {"$match" : 
        {"_id": userId, "isDeleted" : False} 
    },
    {
        "$project" : {
            "postings" : 0,
            "starredPostings" : 0, 
            "user.timestamp" : 0, 
            "user.phone" : { "$cond" : [{"$eq": ["$user.highPrivacy", True]}, 0, "$user.phone"] },
        }
    },
])

触发报错：

pymongo.errors.OperationFailure: Invalid $project :: caused by :: Cannot use expression other than $meta in exclusion projection

错误原因 #

MongoDB的$project操作不允许同时混用排除式投影（字段设为0）和带表达式的包含式投影。你的代码里：

• postings:0、starredPostings:0属于排除式投影（指定要移除的字段）
• 给user.phone赋值$cond表达式属于包含式投影（指定要保留/修改的字段）

这种混合写法违反了MongoDB的投影规则，因此报错。

修复方案 #

方案一：全包含式投影（明确列出所有要保留的字段） #

把需要保留的字段全部明确列出，用$$REMOVE关键字在满足隐私条件时直接移除user.phone字段（比设为0更符合需求，不会留下phone:0的无效键）：

dbConnection.aggregate([
    {"$match": {"_id": userId, "isDeleted": False}},
    {
        "$project": {
            # 保留顶层_id字段（默认保留，可省略）
            "_id": 1,
            # 重构user对象，明确列出所有要保留的子字段
            "user": {
                "name": "$user.name",
                "surname": "$user.surname",
                "email": "$user.email",
                "age": "$user.age",
                "gender": "$user.gender",
                "nationality": "$user.nationality",
                "universityMajor": "$user.universityMajor",
                "preferences": "$user.preferences",
                "highPrivacy": "$user.highPrivacy",
                # 根据隐私开关决定是否保留phone字段
                "phone": {
                    "$cond": [{"$eq": ["$user.highPrivacy", True]}, "$$REMOVE", "$user.phone"]
                }
            }
            # 如果还有其他需要保留的顶层字段，在此处添加
        }
    }
])

方案二：先修改字段再排除（更简洁） #

先用$addFields修改user.phone字段，再用$project排除不需要的字段，避免混合投影规则：

dbConnection.aggregate([
    {"$match": {"_id": userId, "isDeleted": False}},
    # 先处理phone字段：隐私开启时移除该字段，否则保留原值
    {
        "$addFields": {
            "user.phone": {
                "$cond": [{"$eq": ["$user.highPrivacy", True]}, "$$REMOVE", "$user.phone"]
            }
        }
    },
    # 再排除不需要的字段
    {
        "$project": {
            "postings": 0,
            "starredPostings": 0,
            "user.timestamp": 0
        }
    }
])

这个方案不需要列出所有要保留的字段，只需要先调整user.phone，再移除不需要的冗余字段，更适合字段较多的场景。

内容的提问来源于stack exchange，提问作者Ahmet-Salman