Vendure电商平台中EmailPlugin插件报错问题分析

问题现象

在Vendure电商平台的生产环境中，当处理来自Mollie支付网关的订单时，系统尝试发送订单成功确认邮件时会出现错误。错误日志显示"EmailPlugin] Cannot read properties of undefined (reading 'headers')"的异常，导致邮件发送失败。

错误根源

这个问题的根本原因在于RequestContext对象创建时缺少关联的request对象。具体来说：

1. 当Mollie支付网关通过webhook通知Vendure系统订单状态变更时
2. 系统在处理支付成功状态时会尝试发送确认邮件
3. 在生成邮件内容时，需要获取资产的绝对URL
4. 这个URL生成过程需要访问请求头(headers)信息
5. 但由于RequestContext创建时没有传入request对象，导致访问headers属性时抛出异常

技术背景

在Vendure架构中：

• RequestContext对象贯穿整个请求生命周期，包含请求相关的上下文信息
• EmailPlugin负责处理各类邮件发送逻辑
• 资产URL生成需要知道当前请求的主机信息(通常从headers获取)
• Mollie支付网关的webhook回调是系统内部触发，没有传统HTTP请求的完整上下文

解决方案

修复方案相对直接：

1. 从Mollie webhook处理方法中获取request对象
2. 在创建RequestContext时传入该request对象
3. 这样在后续处理中(特别是邮件发送时)就能正确获取headers信息

这种修改保持了系统的一致性，确保无论在用户直接请求还是后台webhook触发的场景下，都能正确处理资产URL生成等需要请求上下文信息的操作。

影响范围

该问题主要影响：

• 使用Mollie支付网关的场景
• 配置了自动发送订单确认邮件的商店
• 生产环境(因为开发环境可能使用不同的资产存储策略)

最佳实践

对于电商平台开发者，在处理类似问题时应注意：

1. 所有需要请求上下文的操作都应确保RequestContext正确初始化
2. 对于后台触发的操作(如webhook)，应模拟必要的请求信息
3. 在插件开发中，要考虑到不同触发场景下的上下文完整性
4. 日志记录应包含足够上下文以便快速定位类似问题

该修复已经由Vendure核心团队确认并处理，用户升级到包含修复的版本即可解决此问题。