Magento 2.4.6购物车问题：重复添加同款子产品未合并数量

• 检查子产品的核心匹配字段
  Magento购物车合并商品的核心逻辑是对比quote_item表中的三个字段：product_id、parent_item_id、super_attribute。直接查询数据库该表，对比两条独立记录：

  • 若super_attribute的序列化内容有差异（比如属性顺序、空格、参数值不一致），系统会判定为不同商品，不会合并。
  • 确认parent_item_id是否指向同一个可配置产品的父记录，父记录不一致也会导致拆分。

• 排查第三方模块/插件的干扰
  很多自定义模块（如促销、自定义购物车逻辑）会重写或插件化Magento\Quote\Model\Quote::addProduct、Magento\ConfigurableProduct\Model\Quote\Item\CartItemOptionsProcessor这类核心类，破坏默认合并逻辑：

  • 临时禁用所有第三方模块，切换到Luma主题测试，看是否恢复合并功能。
  • 查看项目di.xml文件，检查是否有针对上述核心类的重写或插件，重点排查aroundAddProduct、processOptions方法的自定义实现。

• 核对产品属性配置
  确认可配置产品与子产品的属性关联正确：

  • 进入可配置产品编辑页，检查「超级属性」标签下的属性是否完整，子产品的对应属性值无重复或异常。
  • 子产品的visibility属性需设置为「不单独可见」，若设为单独可见，添加时可能绕过可配置产品的合并逻辑。

• 检查系统配置项
  确认后台配置未禁用合并功能：

  • 进入Stores > Configuration > Sales > Checkout > Shopping Cart，查看「Merge Configurable Products」是否设为「Yes」。
  • 若开启「Allow Multiple Shipping Addresses」，且用户选择多地址配送，同商品也会被拆分为多条记录。

• 清理缓存与会话

  • 执行bin/magento cache:flush清理所有缓存，包括页面缓存和会话缓存，避免旧数据干扰。
  • 用不同浏览器或隐身模式测试，排除前端会话存储异常。

• 检查核心代码是否被篡改
  若核心代码被修改，比如Magento\Quote\Model\Quote::getItemByProduct方法（负责查找购物车中已存在的同款商品），会导致匹配逻辑失效。对比官方Magento 2.4.6的核心代码，确认该方法的属性匹配逻辑未被改动。

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