在处理复杂的业务数据时，单纯的查询往往无法直接输出符合前端展示要求的数据结构。MongoDB的聚合框架提供了强大的数据处理流水线，其中$project阶段是控制输出文档形态的核心环节。它不仅决定了最终文档包含哪些字段，还能通过表达式对字段进行计算和重组，从而实现文档结构的深度重塑。
$project基础语法与字段控制规则
$project阶段的基础功能是对输入文档的字段进行筛选，这与常规查询中的投影概念相似，但在聚合管道中拥有更严格的规则。其基本语法结构是在$project对象内，以字段名为键，以1或0为值来表示包含或排除该字段。需要注意的是，在同一个$project阶段中，除了_id字段之外，不能同时存在包含和排除的指令。也就是说，如果你明确指定了某个字段为1，那么未列出的字段将被自动过滤掉；反之，如果指定了某个字段为0，则未列出的字段会被保留。
关于_id字段，MongoDB默认会在每个聚合阶段输出它。如果不需要在结果中展示_id，必须显式地将其设置为0，这是唯一一个可以与其它字段的包含指令共存的排除指令。这种设计保证了文档主键的可追溯性，同时给予了开发者最大的控制灵活性。在实际开发中，为了减少网络传输开销和内存占用，建议在管道的早期阶段就使用$project过滤掉不需要的字段，尤其是那些体积较大的非结构化数据。
// 基础投影示例：仅保留name和price字段，并排除_id
db.products.aggregate([
{
$project: {
name: 1,
price: 1,
_id: 0
}
}
])
利用表达式重塑文档结构
$project的真正威力在于其支持丰富的表达式操作符。通过在字段位置使用以$开头的表达式，我们可以对现有字段的值进行计算、拼接或格式转换，从而生成全新的字段。这种机制打破了原有文档的结构限制，允许开发者根据业务逻辑自由拼装数据。例如，在电商系统中，商品原价和折扣价可能分别存储在不同的字段中，我们可以直接在投影阶段计算出最终的售价，甚至将其重命名并嵌套在一个特定的对象中，使输出结果更符合前端的消费习惯。
除了简单的数学运算，字符串操作和日期格式化也是常用的重塑手段。通过$concat、$substr等操作符，可以将分散的姓氏和名字拼接为全名，或者从身份证号中提取出生日期。而$dateToString则能将复杂的Date对象转换为易读的字符串格式。在构建嵌套结构时，只需在字段名中使用点号或者直接定义嵌套对象即可。这种能力使得$project不仅仅是一个过滤器，更是一个文档形态的转换器，极大地提升了数据处理的灵活性。
// 表达式重塑示例：计算折后价格并重组结构
db.products.aggregate([
{
$project: {
productName: "$name", // 重命名字段
_id: 0,
pricing: { // 构建嵌套对象
originalPrice: "$price",
finalPrice: { $multiply: ["$price", { $subtract: [1, "$discountRate"] }] },
currency: "CNY"
},
createdDate: { // 日期格式化
$dateToString: {
format: "%Y-%m-%d",
date: "$createdAt"
}
}
}
}
])
进阶应用：条件判断与数组操作
在更复杂的业务场景中，简单的字段映射和数学计算往往不够用，这时就需要引入条件逻辑和数组处理能力。$project支持$cond、$switch和$ifNull等条件表达式，允许根据文档的不同属性输出不同的结构或值。例如，当需要根据用户的会员等级显示不同的折扣率，或者当某个字段可能不存在时提供一个默认值，条件表达式就能发挥关键作用。这种逻辑前置到数据库层处理，可以有效减少应用层代码的复杂度，避免在业务逻辑中充斥着大量的空值判断。
对于包含数组字段的文档，$project同样提供了强大的重塑能力。虽然基础的$project不能直接改变数组元素的结构，但结合$map、$filter等数组表达式，可以在投影阶段对数组内的每个元素进行遍历和转换。比如，在一个订单文档中，商品列表是一个数组，我们可以使用$map表达式遍历该数组，为每个商品对象添加一个计算后的总价字段，或者使用$filter过滤掉已下架的商品。这种操作使得输出文档中的数组内容完全符合后续处理或展示的需求，无需在应用层进行二次循环。
// 条件与数组操作示例
db.orders.aggregate([
{
$project: {
orderId: "$_id",
customerLevel: {
$switch: {
branches: [
{ case: { $gte: ["$totalPoints", 1000] }, then: "VIP" },
{ case: { $gte: ["$totalPoints", 500] }, then: "Gold" }
],
default: "Regular"
}
},
// 使用$map重塑商品数组结构
processedItems: {
$map: {
input: "$items",
as: "item",
in: {
name: "$$item.name",
quantity: "$$item.qty",
subtotal: { $multiply: ["$$item.price", "$$item.qty"] }
}
}
}
}
}
])
通过对$project阶段的深入理解，我们可以发现它在聚合管道中扮演着承上启下的重要角色。它既能精简数据流，降低后续阶段的处理压力，又能通过表达式构建出完全符合业务需求的定制化文档结构。掌握字段控制规则、表达式重塑以及条件与数组操作，是提升MongoDB数据聚合能力的关键所在。