Magento 2 SagePay Suite唯一约束冲突错误排查求助

刚好之前处理过类似的Magento + SagePay Suite的问题，给你梳理下这个SagePaySuiteLogger.Exception: Unique constraint violation found错误的来龙去脉和可行的解决办法：

问题成因分析 #

这个错误本质是重复插入违反了数据库表的唯一约束，具体触发场景通常有这几种：

• 日志模块重复写入：SagePay Suite的日志组件在同一支付流程中被多次调用（比如异常捕获分支、回调确认环节重复触发），而sage_pay_suite_log表的某个字段组合（比如transaction_id+log_type）被设置了唯一索引，导致重复插入时触发报错。
• 表单集成的回调重复触发：表单模式下，SagePay的支付成功回调可能因为网络波动、SagePay的重试机制被多次发送到你的Magento站点，而回调处理代码没有做幂等校验，重复执行了日志写入逻辑。
• 旧版本代码漏洞：1.2.4版本的SagePay Suite存在逻辑缺陷，比如在支付确认的流程分支中，没有判断日志是否已存在就直接执行插入操作。

修复方案 #

临时快速修复（应急用） #

如果不想改动代码，可以先调整数据库的唯一约束：

1. 先查询日志表的唯一索引：

   SHOW INDEX FROM sage_pay_suite_log;
   

2. 找到对应的唯一索引名称（比如UNQ_SAGE_PAY_SUITE_LOG_TRANSACTION_ID_LOG_TYPE），执行删除命令：

   ALTER TABLE `sage_pay_suite_log` DROP INDEX `UNQ_SAGE_PAY_SUITE_LOG_TRANSACTION_ID_LOG_TYPE`;
   

   这个方法能快速绕过错误，但可能会导致日志表出现重复记录，适合临时应急。

代码层面的根本修复 #

1. 给日志写入添加幂等校验

找到SagePay Suite的日志模型类（通常是Ebizmarts\SagePaySuite\Model\Logger），在日志保存的方法中加入重复校验逻辑：

// 假设日志模型的保存方法是saveLog()
public function saveLog($transactionId, $message, $logType)
{
    // 先检查是否已有相同的日志记录
    $existingLog = $this->_logCollection->addFieldToFilter('transaction_id', $transactionId)
        ->addFieldToFilter('log_type', $logType)
        ->addFieldToFilter('message', $message)
        ->getFirstItem();

    if (!$existingLog->getId()) {
        // 只有不存在时才插入新日志
        $log = $this->_logFactory->create();
        $log->setTransactionId($transactionId)
            ->setMessage($message)
            ->setLogType($logType)
            ->save();
    }
}

2. 修复回调重复处理问题

在回调处理控制器（比如Ebizmarts\SagePaySuite\Controller\Callback\Success）中添加订单状态校验，避免重复处理：

public function execute()
{
    $orderIncrementId = $this->getRequest()->getParam('orderId');
    $order = $this->_orderFactory->create()->loadByIncrementId($orderIncrementId);

    // 如果订单已经完成，直接返回，不再执行后续逻辑
    if ($order->getStatus() == \Magento\Sales\Model\Order::STATE_COMPLETE) {
        $this->getResponse()->setBody('Order already processed');
        return;
    }

    // 原有回调处理逻辑...
}

3. 升级模块版本

虽然你提到其他版本也存在这个问题，但建议尝试升级到最新的SagePay Suite稳定版——官方大概率已经修复了这个日志重复写入的bug。升级前务必备份数据库和代码，避免兼容性问题。

额外排查建议 #

• 查看服务器的Nginx/Apache日志，确认是否有重复的SagePay回调请求；
• 开启Magento的调试日志（var/log/debug.log），跟踪日志写入的触发流程，定位重复调用的代码位置。

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