Magento2新账号注册登录后购物车商品quote_item_option丢失修复

排查路径 #

• 先埋点定位数据丢失的具体节点：在访客生成购物车、注册接口触发前、账号注册成功、购物车合并逻辑执行完成4个关键节点，分别打印当前quote_id、关联商品item的全量option字段值，快速定位是注册流程中数据被删，还是登录时合并购物车环节丢了数据。重点断点盯Magento\Quote\Model\Quote::merge方法、注册后将访客quote绑定到新用户的逻辑段，顺着调用栈找触发option删除的代码位置。
• 排查自定义代码与第三方插件冲突：先禁用所有和购物车、用户注册、商品自定义选项、促销规则相关的第三方插件及站点自定义代码，复现「访客加购→注册→登录」流程，如果问题消失，逐个开启插件定位冲突源。重点检查绑定在customer_save_after、quote_merge_after、sales_quote_item_save_before这些事件上的监听逻辑，很多定制商品插件、自定义加价插件容易在这里出问题：没有判断当前quote是访客态还是已绑定用户态，注册触发事件时直接把非系统默认的option字段清空。
• 直接查库核对数据状态：对比访客态quote、注册后绑定到新用户的quote在quote_item_option表中的关联记录，确认是option记录被物理删除，还是option值被覆写为空。如果是物理删除，排查是否存在错误的外键级联配置——比如给quote_item表配置了关联customer表的外键，更新quote的customer_id字段时触发级联删除删掉了关联option；同时检查清理无效quote的定时任务，看是否误把刚绑定到新用户的有效quote判定为过期访客数据清空。如果是option值被覆写为空，开启数据库SQL日志，找到对应UPDATE语句溯源调用方。
• 校验购物车合并逻辑的兼容性：Magento默认注册后会自动合并访客购物车和账号下已存在的购物车，原生合并逻辑只会复制系统内置的商品option，站点自定义的quote_item_option如果没加入合并白名单，合并时会被直接丢弃。可以直接在Magento\Quote\Model\Quote\Item::addOption方法打断点，看注册流程中是否存在分支跳过了自定义option的写入。

修复方案 #

• 修复事件监听逻辑漏洞：如果定位到是事件监听代码的问题，在对应处理逻辑中增加quote状态判断，非明确需要清空option的业务场景，禁止遍历删除quote item的option数据；如果是需要同步option的逻辑，补全自定义option的字段映射，不要只保留系统默认字段。
• 补全购物车合并时的自定义option同步逻辑：给quote合并流程加after插件，遍历原访客quote的所有item option，把不在默认白名单的自定义option逐个复制到合并后的quote item上，操作完成后执行collectTotals()和持久化操作，核心代码参考：

public function afterMerge(
    \Magento\Quote\Model\Quote $subject,
    \Magento\Quote\Model\Quote $result,
    \Magento\Quote\Model\Quote $guestQuote
) {
    foreach ($guestQuote->getAllItems() as $guestItem) {
        $matchedItem = $result->getItemByProduct($guestItem->getProduct());
        if (!$matchedItem) {
            continue;
        }
        foreach ($guestItem->getOptions() as $option) {
            if (!$matchedItem->getOptionByCode($option->getCode())) {
                $matchedItem->addOption($option);
            }
        }
    }
    $result->collectTotals()->save();
    return $result;
}

• 修正数据库与定时任务配置：删掉quote、quote_item表上配置错误的级联删除外键；调整清理无效quote的定时任务规则，增加is_active = 0、quote创建时间超过预设有效期（比如7天）的判断条件，避免误删刚绑定到新注册用户的有效购物车数据。
• 增加兜底校验逻辑：在用户注册、登录成功的跳转节点加一层轻量校验，如果发现当前用户quote下的商品item核心option缺失，就从session/缓存中存储的访客购物车备份（设置15分钟有效期）里恢复数据，避免用户直接看到购物车商品丢失的异常。

修复完成后必须执行缓存清理操作，运行命令php bin/magento cache:clean，同时覆盖测试多类场景：包括加购带自定义选项的商品、加购促销价商品、加购多规格商品后注册的流程，确认所有商品option都能正常保留，购物车商品无丢失。

内容的提问来源于stack exchange，提问作者i like magento