不能直接用嵌套对象存商品属性，因为会导致查询无法走索引、聚合性能差、跨类目字段不统一、校验和序列化易错；Attribute Pattern 通过将每个属性拆为独立文档（含 product_id、key、value、type 等字段）并配合合理索引，实现可查、可索引、可扩展。
为什么不能直接用嵌套对象存商品属性
MongoDB 里把商品属性全塞进一个 attributes 对象（比如 { "color": "red", "size": "M", "weight_kg": 0.5 }）看似简单，但很快会遇到几个硬伤：查询 size = "XL" 时没法走索引（除非建通配符索引，但代价高）；聚合时想按属性名分组或筛选，得靠 $objectToArray，性能差还写法绕；更麻烦的是，不同类目商品属性完全不同（手机有 ram_gb，衣服有 fit_type），字段名无法统一，应用层校验和序列化也容易出错。
Attribute Pattern 的核心不是“怎么存”，而是“怎么让属性可查、可索引、可扩展”。它要求把每个属性拆成独立文档项，而不是堆在单个对象里。
标准 Attribute Pattern 结构怎么建模
最稳妥的做法是把每个属性值单独建一条记录，用固定字段描述其元信息：
{
"product_id": "prod_123",
"key": "color",
"value": "navy",
"type": "string",
"indexed": true
}
关键点：
-
key必须是字符串，且小写+下划线（避免大小写混用导致查询遗漏） -
value类型不强制统一，但建议按type字段区分存储（比如数字存为NumberInt或Double，布尔存为Boolean），否则$gt查询会失败 - 必须对
{ product_id: 1, key: 1 }建复合索引，否则按商品查所有属性会扫全表 - 如果需要高频按某个属性查（如
color），额外建{ key: 1, value: 1 }索引——但注意：字符串值要控制长度，过长的value会让索引膨胀
如何支持多语言/多单位属性值
纯 value 字段撑不住国际化场景。别把翻译塞进 value（比如 "value": {"zh": "深蓝", "en": "navy"}），这会让索引失效、查询变重。正确做法是加一层抽象：
{
"product_id": "prod_123",
"key": "color",
"locale": "en",
"unit": null,
"value": "navy",
"type": "string"
}
或者单位敏感的场景（如重量）：
{
"product_id": "prod_123",
"key": "weight",
"locale": "zh",
"unit": "kg",
"value": 0.45,
"type": "number"
}
这样既能按 key + locale 查，也能按 key + unit 聚合，且所有字段都可索引。唯一要注意的是：应用层读取时需明确指定 locale 和 unit，否则可能漏掉数据。
聚合查询时怎么还原成“一个商品+所有属性”
用 $lookup 关联属性集合是最常见需求，但容易写出低效语句。错误示范：$lookup 不带 pipeline，直接拉全量属性再内存过滤：
// ❌ 别这么写：没加 pipeline，查一个商品可能拉回几百条无关属性
{
$lookup: {
from: "product_attributes",
localField: "_id",
foreignField: "product_id",
as: "attributes"
}
}
正确写法是在 pipeline 里提前过滤，并限制字段：
// ✅ 加 pipeline + 投影，只取需要的 key
{
$lookup: {
from: "product_attributes",
localField: "_id",
foreignField: "product_id",
pipeline: [
{ $match: { key: { $in: ["color", "size", "brand"] } } },
{ $project: { _id: 0, key: 1, value: 1, type: 1 } }
],
as: "attributes"
}
}
如果前端需要键值对格式（{"color": "navy", "size": "M"}），再补一个 $arrayToObject，但注意：该操作不能下推到存储层，大数据量时慎用。
Attribute Pattern 看似多了一层抽象，但它把“变化”锁在了数据结构里，而不是靠应用逻辑硬扛。最容易被忽略的其实是索引策略——很多团队建了 pattern 却忘了给 key 和 value 单独建索引，结果查询一慢，就回头怪模式设计，其实只是没配对索引。
