Shopware 6 中嵌套 LineItem 的作用与实践指南

嵌套 LineItem 是 Shopware 6 最新支持的核心功能，用于在购物车或订单中构建父子关系的商品结构（如可配置商品及其选项），虽无原生后台界面支持，但被 Custom Products 等最新扩展深度使用。

嵌套 LineItem 是 Shopware 6 最新支持的核心功能，用于在购物车或订单中构建父子关系的商品结构（如可配置商品及其选项），虽无原生后台界面支持，但被 Custom Products 等最新扩展深度使用。

在 Shopware 6 的订单与购物车模型中，LineItem 不仅可表示独立商品，还可通过 setChildren() 方法关联子项，形成树状结构。这种嵌套能力并非实验性 API，而是经过完整单元测试、持续维护的正式特性——正如最新测试用例所示：

$cart = new Cart('test', 'test');

$nestedItem = (new LineItem('custom-shirt', 'product'))
->setChildren(new LineItemCollection([
(new LineItem('color-red', 'property'))->setGood(false)->setStackable(false),
(new LineItem('size-xl', 'property'))->setGood(false)->setStackable(false),
(new LineItem('embroidery-name', 'customization'))->setGood(false)->setPrice(new Price(199, 199)),
]));

$cart->add($nestedItem);

这种结构在业务上最常见的落点，就是高度定制化商品场景。比如一件 T 恤，通常会作为父级 LineItem 存在；而颜色、尺码、刺绣文字这类定制选项，则作为不能单独购买的子项挂在下面。子项可以通过 setGood(false) 明确标记为非独立商品，同时再借助 setPrice() 单独写入附加费用。这样处理的好处很直接：结算逻辑更清楚，报表归因也更准确。

值得注意的是：

• ✅ 后端完全支持：Cart, Order, OrderTransaction 及相关事件均兼容嵌套结构；数据库中通过 parent_id 字段持久化层级关系；
• ⚠️ 前台/后台 UI 缺失：默认管理后台“创建订单”及 Storefront 标准购物车组件不提供嵌套创建入口，需插件自行实现表单逻辑与数据组装；
• ? 推荐实践：在自定义插件中，应在 CartProcessor 或 LineItemFactory 中动态构建嵌套结构，并配合 LineItemFlatCollection::getFlat() 获取扁平化列表用于总价计算，同时保留 getChildren() 以支持明细展示与导出。

总之，嵌套 LineItem 是 Shopware 6 面向复杂电商场景的关键建模能力——它不追求开箱即用的 UI，而是为插件开发者提供语义明确、结构稳健的数据契约，是构建专业级商品配置器、B2B 套餐、订阅组合等高级功能的底层基石。