Magento 2废弃购物车判定规则及自动邮件模块开发咨询

Hey there! Let's tackle your Magento 2 abandoned cart questions one by one—this is a super common pain point when building custom modules, so I’ve got you covered.

1. 什么时候Magento 2会把购物车判定为废弃？ #

Magento 2的默认废弃购物车判定逻辑是基于几个核心条件的组合：

• 时间阈值：默认是用户最后一次操作购物车后1小时（这个时长可以在后台配置：Stores > Settings > Configuration > Sales > Checkout > Shopping Cart > Abandoned Cart Lifetime），超过这个时间未完成结账就会被标记。
• 购物车有效性：购物车必须满足：
  • 包含至少1件可售商品（库存正常、状态可购买）
  • 关联了有效的邮箱地址（不管是登录用户的邮箱，还是访客在结账流程中填写的邮箱——这是关键！如果访客没留邮箱，系统连发送对象都没有，根本不会纳入废弃购物车统计）
  • 购物车处于活跃状态（quote表中is_active字段为1，未被删除或合并）
  • 用户从未完成订单提交（购物车对应的quote_id没有关联到sales_order表中的订单）

2. 自定义废弃购物车邮件模块触发异常的排查与解决 #

你遇到的“仅创建购物车离开不触发上报”的问题，本质是默认机制或你的自定义逻辑没满足触发的前置条件，下面是具体的技术细节和排查步骤：

核心原因拆解 #

Magento 2的废弃购物车流程依赖两个核心环节：

1. 购物车数据的完整追踪：系统必须记录用户的最后活动时间和关联邮箱
2. 定时任务（Cron）的扫描执行：默认通过sales_send_abandoned_cart_email这个Cron任务来批量扫描符合条件的购物车，触发邮件发送

关键检查点 #

• 邮箱是否已关联：先去数据库的quote表查看对应购物车的customer_email字段是否有值。如果访客只是打开页面创建了购物车（没进结账页填邮箱，也没通过其他方式留邮箱），这条记录会被系统直接跳过，因为无法发送邮件。
• 最后活动时间是否更新：检查quote表的updated_at字段——如果用户只是创建了空购物车或者没有任何操作（比如没加商品），这个字段可能不会被正确更新，导致Cron任务判断“未超过废弃时长”。
• Cron任务是否正常运行：如果你的模块依赖默认Cron触发，去后台System > Tools > Cron Scheduler查看sales_send_abandoned_cart_email任务是否按时执行。如果是自定义Cron，检查你的crontab.xml配置是否正确，比如执行频率、权限是否足够。
• 购物车状态是否合格：确认quote表中items_count > 0，is_active = 1，且没有关联到已完成的订单。

可行的修复方案 #

• 补充邮箱收集逻辑：如果你的场景需要覆盖未填写邮箱的访客，可以在用户添加商品后弹出邮箱收集弹窗，通过Magento的API更新对应quote的customer_email字段，确保系统有发送对象。
• 自定义Cron扫描逻辑：在你的模块中创建专属的Cron任务，直接扫描数据库中符合条件的购物车，示例SQL逻辑：

  SELECT entity_id, customer_email FROM quote 
  WHERE customer_email IS NOT NULL 
    AND items_count > 0 
    AND is_active = 1 
    AND updated_at < DATE_SUB(NOW(), INTERVAL 1 HOUR) 
    AND entity_id NOT IN (SELECT quote_id FROM sales_order);
  

  拿到这些购物车ID后，调用你的邮件发送逻辑即可。
• 前端监听页面离开事件：虽然浏览器对页面离开事件有限制，但可以用navigator.sendBeacon来异步上报购物车状态，确保updated_at字段被更新：

  window.addEventListener('beforeunload', function() {
    const quoteId = document.querySelector('input[name="quote_id"]').value;
    if (quoteId) {
      navigator.sendBeacon('/your-module/cart/record-abandon', JSON.stringify({quote_id: quoteId}));
    }
  });
  

  然后在你的模块控制器中接收请求，更新对应quote的updated_at字段，让Cron任务能正确识别。

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