InvoiceNinja中Mollie支付重复记录问题的分析与解决方案

问题背景

在使用InvoiceNinja（版本v5.10.29）的自托管环境中，当客户通过Mollie支付网关使用iDeal方式支付发票时，系统会错误地创建两笔相同的支付记录。这两笔支付具有完全相同的金额、发票编号、日期、类型和交易参考号，但状态不同：一笔标记为"已完成"，另一笔则为"未应用"。

技术分析

问题根源

经过深入分析，这个问题源于Mollie支付网关的两种通知机制同时触发：

1. 交易状态轮询：InvoiceNinja主动向Mollie查询支付状态
2. Webhook回调：Mollie在支付完成后主动向InvoiceNinja发送支付通知

当这两种机制在极短时间内（几乎同时）触发时，系统虽然会检查交易参考号是否已存在，但由于并发处理的时间差，可能导致两笔支付记录都被保存。

现象细节

从系统日志中可以观察到：

• 两笔支付记录创建时间仅相差几毫秒
• 关联的活动记录显示不同的IP地址（一个IPv4和一个IPv6）
• 支付活动记录显示完整的支付流程被重复执行了两次

解决方案

InvoiceNinja开发团队在v5.10.30版本中实施了以下修复措施：

1. 延长Webhook处理延迟：通过增加Webhook处理的延迟时间，确保系统有足够时间处理交易状态查询结果，避免并发冲突
2. 优化事务处理机制：增强对支付记录的唯一性检查，防止重复记录

最佳实践建议

对于使用Mollie支付网关的InvoiceNinja用户，建议：

1. 及时升级：确保系统升级到v5.10.30或更高版本
2. 监控支付记录：定期检查支付记录，确认没有重复支付
3. 处理重复记录：如果发现重复支付，可以安全地删除状态为"未应用"的记录

总结

支付系统的并发处理是一个常见的技术挑战。InvoiceNinja通过优化Webhook处理机制，有效解决了Mollie支付重复记录的问题。这一改进不仅提升了系统的可靠性，也为用户提供了更准确的财务数据记录。