如何阻止Shopware 6.4.17生成重复订单？（Varnish环境）

后端幂等性控制（适配Varnish） #

• 购物车状态锁定：在订单创建流程最前端添加购物车处理状态校验，借助Redis或Shopware自定义字段标记处理中的购物车，重复请求检测到该状态时直接返回错误。
  示例代码（可在自定义插件的OrderService装饰器中实现）：

  public function createOrder(ShopContext $context, Cart $cart): OrderEntity
  {
      $cartId = $cart->getId();
      $redis = $this->redisConnection;
      
      // 检查购物车是否正在处理
      if ($redis->get("cart_processing_$cartId")) {
          throw new \RuntimeException('订单正在处理中，请稍后重试');
      }
      
      // 设置30秒过期的处理锁（可根据下单流程时长调整）
      $redis->setex("cart_processing_$cartId", 30, '1');
      
      try {
          // 执行原订单创建逻辑
          $order = $this->decorated->createOrder($context, $cart);
          $redis->del("cart_processing_$cartId");
          return $order;
      } catch (\Exception $e) {
          $redis->del("cart_processing_$cartId");
          throw $e;
      }
  }
  

• 请求ID幂等校验：要求前端在下单请求头中携带唯一X-Request-ID，后端存储已处理的请求ID，重复请求直接返回已处理结果。Varnish默认不缓存带自定义头的POST请求，该方案不受缓存影响。
  示例代码（在Storefront下单控制器中添加）：

  public function confirmOrder(Request $request, ShopContext $context): Response
  {
      $requestId = $request->headers->get('X-Request-ID');
      if (!$requestId) {
          return new JsonResponse(['error' => '缺少请求ID'], 400);
      }
      
      $redis = $this->redisConnection;
      if ($redis->get("processed_request_$requestId")) {
          return new JsonResponse(['message' => '订单已提交'], 200);
      }
      
      try {
          // 执行原下单逻辑
          // ...
          $redis->setex("processed_request_$requestId", 86400, '1'); // 记录1天
          return $this->redirectToRoute('frontend.checkout.finish.page');
      } catch (\Exception $e) {
          return $this->handleError($e);
      }
  }
  

前端防重复提交优化 #

• 提交按钮即时禁用：用户点击下单按钮后立即禁用，直到请求完成（成功/失败）再恢复，避免重复点击。示例JS代码：

  document.querySelector('#checkout-confirm-button').addEventListener('click', function(e) {
      const button = e.target;
      button.disabled = true;
      button.textContent = '提交中...';
      
      // 生成唯一请求ID
      function uuidv4() {
          return ([1e7]+-1e3+-4e3+-8e3+-1e11).replace(/[018]/g, c =>
              (c ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> c / 4).toString(16)
          );
      }
      
      // 发起下单请求
      fetch('/checkout/confirm', {
          method: 'POST',
          headers: {
              'X-Request-ID': uuidv4(),
              'Content-Type': 'application/x-www-form-urlencoded'
          },
          body: new FormData(document.querySelector('#checkout-form'))
      }).then(response => {
          button.disabled = false;
          button.textContent = '确认下单';
          // 处理跳转或提示
      }).catch(error => {
          button.disabled = false;
          button.textContent = '确认下单';
          // 错误提示
      });
  });
  

• 点击防抖处理：对按钮点击事件添加防抖逻辑，比如3秒内只允许触发一次提交，避免快速重复点击。

Varnish环境配置调整 #

• 确保下单相关POST请求不被缓存，在VCL配置的vcl_recv段添加：

  if (req.method == "POST" && req.url ~ "^/checkout/") {
      return (pass);
  }
  

• 允许自定义请求头X-Request-ID传递到后端，在VCL的vcl_recv段添加：

  set req.http.X-Request-ID = req.http.X-Request-ID;
  

社区解决方案参考 #

Shopware社区中有不少开发者遇到过相同问题，主流解决思路都是后端幂等性校验+前端交互限制结合，部分开发者通过自定义插件封装了完整的防重复提交逻辑，可直接适配Varnish环境。

内容的提问来源于stack exchange，提问作者Michał Jankowski