Shopware中LineItemEntity的payload与customFields字段使用场景问询

优先用 payload 的场景 #

payload 本质是为临时、上下文绑定的动态数据设计的，适合存那些不需要长期持久化，只和当前订单/行项的生命周期强相关的内容：

• 订单流程中的计算中间值：比如折扣规则的临时计算参数、配送费的动态核算依据，这些数据只是生成最终订单时的过渡数据，后续不需要调用或修改
• 第三方服务的临时交互数据：比如支付网关返回的临时会话ID、物流接口的临时追踪令牌，完成支付/发货流程后这些数据就失去作用
• 订单生成时的上下文快照：比如用户下单时的设备信息、当时生效的促销活动临时规则，仅作为订单生成场景的记录，不需要后续维护

优先用 customFields 的场景 #

customFields 是为长期、业务导向的自定义数据准备的，适合存那些需要持久保存、和行项业务属性绑定的内容：

• 业务定制化参数：比如客户对商品的个性化定制要求（刻字内容、定制尺寸）、行项专属的特殊备注，这些是订单核心业务信息的一部分，需要长期留存
• 后台可编辑/展示的自定义字段：通过Shopware后台配置customFields的类型后，可以直接在后台管理界面查看或修改这些数据，适合需要运营人员干预的场景
• 长期业务逻辑依赖的数据：比如行项的特殊分类标识、供应商自定义编码，这些数据会在后续的库存统计、报表生成、售后处理中被调用

核心区分点 #

payload 是「用完即弃或仅作快照」的临时数据容器，不适合作为核心业务数据存储；customFields 是「持久化可扩展」的业务数据载体，用于补充Shopware原生字段覆盖不到的业务需求。

内容的提问来源于stack exchange，提问作者Quisse