Django-Oscar后台创建发货事件未触发handle_shipping_event问题

在Django-Oscar 3.1（Python 3.8.10）环境下，我在管理后台修改发货事件类型并尝试给客户发送邮件，但发现自定义的handle_shipping_event方法未被调用。目前已经创建发货事件类型并关联了通信事件类型，也继承了order/processing.py中的EventHandler并添加了发送邮件的函数，能看到发货事件已写入数据库，但方法里的print语句没有输出，说明方法根本没执行。

自定义代码示例 #

from oscar.apps.order.processing import EventHandler as CoreEventHandler

class EventHandler(CoreEventHandler):
    def handle_shipping_event(self, order, event_type, lines,
                              line_quantities, **kwargs):

        print('It does not print this')
        # Example implementation
        self.validate_shipping_event(
            order, event_type, lines, line_quantities, **kwargs)

        # send tracking mail
        self.send_shipped_email(order)

        return self.create_shipping_event(
            order, event_type, lines, line_quantities, **kwargs)

• 确认自定义EventHandler是否注册生效
  Django-Oscar需要明确指定使用自定义的EventHandler，在项目settings.py中添加配置：

  OSCAR_HANDLERS = {
      'order': 'your_app.order.processing.EventHandler',
  }
  

  替换your_app为实际应用名称，确保路径指向自定义的EventHandler类。

• 检查后台触发事件的逻辑路径
  Oscar管理后台创建发货事件时，若直接调用create_shipping_event而非handle_shipping_event，会绕过自定义方法。可以查看Oscar原生OrderAdmin类的代码，确认后台处理发货事件的流程是否经过EventHandler的handle_shipping_event方法。

• 验证事件类型的关联配置
  确认创建的发货事件类型，已正确关联对应的通信事件类型，且后台触发事件的流程需要经过EventHandler的处理逻辑。部分场景下直接创建事件会跳过handle方法的调用。

• 排查是否存在多重载冲突
  若项目中有多个应用重载了EventHandler，可能存在优先级问题导致自定义类未被使用。可以通过以下代码验证：

  from your_app.order.processing import EventHandler
  print(EventHandler.__module__)
  

  确认输出为自定义模块路径，而非Oscar原生模块。

• 改用日志替代print调试
  后台环境（如uWSGI、Gunicorn）中print输出可能不会显示到控制台，建议使用Django日志系统：

  import logging
  logger = logging.getLogger(__name__)
  
  class EventHandler(CoreEventHandler):
      def handle_shipping_event(self, order, event_type, lines, line_quantities, **kwargs):
          logger.info('handle_shipping_event triggered for order %s', order.number)
          # 其他代码...
  

  查看Django日志文件确认方法是否被调用。

内容的提问来源于stack exchange，提问作者Bahadır Özkan