Skip to main content

​
概述

本指南帮助你排查 Upcart 无法打开，或客户被重定向到购物车页面而看不到 Upcart 抽屉的情况。大多数此类问题是由主题购物车类型设置、Enhanced AJAX API Compatibility 配置、第三方应用重定向或 checkout 按钮路由引起的。
如果 Upcart 完全无法打开或重定向到购物车页面，请参阅排查 Upcart 无法打开或重定向到购物车页面的问题获取更全面的排查指南。

​
应选择哪种购物车类型

在深入排查之前，请先检查主题的购物车类型设置，因为这是最常见的原因。
  • Page——这通常是最佳选项，因为 Upcart 会拦截对 /cart 页面的请求。
  • Drawer——如果 Upcart 无法启动且 /cart 页面被触发，请选择此项。
  • Confirmation Popup——如果你的主题支持此选项且其他选项无法解决问题，可使用此项。
测试这两个选项只需几分钟，但 Page 通常是最有效的选择。

​
如何在主题中更改购物车类型

  1. 在 Shopify 管理后台前往 Online Store > Themes > Customize。
  2. 打开 Theme Settings > Cart > Cart Type。
  3. 根据你要排查的行为，选择 Page 或 Drawer。
  4. 保存更改并在店面上测试购物车。
Shopify 主题编辑器购物车设置中显示购物车类型选项
如果你找不到此设置，请联系你的主题开发者。此设置由你的主题控制，Upcart 无法直接修改。

​
排查步骤

如果更改购物车类型无法解决问题，请按顺序执行以下步骤。

​
1. 检查 Enhanced AJAX API Compatibility

此设置控制 Upcart 处理 Add to Cart 事件的方式，是重定向问题最常见的原因之一。
  1. 前往 Upcart > Cart Editor > Settings > Cart settings，然后展开 Advanced Settings。
  2. 找到 Enhanced Ajax API compatibility。
  3. 对于大多数商店，此设置默认禁用。禁用时，Upcart 会拦截 Add to Cart 调用并防止重定向。
  4. 如果它已启用，其他应用可以接管购物车行为并将客户重定向到购物车页面。请尝试禁用并测试。
  5. 如果禁用后引发其他问题，请重新启用，并改用手动 Upcart API（upcartRegisterAddToCart）。
有关此设置的完整指南，请参阅 Enhanced AJAX API Compatibility。

​
2. 检查第三方应用重定向

许多第三方应用会覆盖购物车行为，并可能将客户重定向离开 Upcart 抽屉。如果你的 Add to Cart 按钮明确将客户带到购物车页面，请参阅为什么”Add to Cart”跳转到购物车页面而不是 Upcart？了解更多详情。 打开任何与购物车相关的应用的设置，查找类似以下的选项：
  • Redirect to cart
  • Go to cart after add
  • Automatically open cart page
  • Action after product is added
将这些选项改为 Stay on page 或 Do nothing。 常见的应用专属修复方法：
  • PageFly——在 PageFly 应用设置中禁用重定向规则。
  • Globo Product Options——停用自动重定向到 Shopify 购物车。
  • Replo——调整 “go to page” 设置以启用 cart drawer。
  • Zepto Product Personalizer——前往 Zepto > Settings > Add to Cart Settings，将 “Action after a product is added to the cart” 改为 “Stay on the product page and show a success message”。
如果不确定是哪个应用导致冲突，请逐个禁用与购物车相关的应用，并在每次禁用后进行测试，直到 Upcart 恢复正常工作。

​
3. 检查 checkout 按钮路由

如果客户点击 Upcart 内的 checkout 按钮后被重定向到购物车页面而不是 checkout：
  1. 前往 Upcart > Cart Editor > Settings > Cart settings。
  2. 找到 “Go to cart page when pressing checkout button”。
  3. 将其关闭。
  4. 保存并测试。
自定义 checkout 页面重定向需要高级编码，Upcart 不直接支持。如果你需要将客户引导到自定义 checkout 页面，需要与开发者合作。

​
4. 检查主题购物车重定向设置

某些主题会在添加商品后自动重定向客户，完全绕过 Upcart。
  1. 前往 Online Store > Themes > Customize。
  2. 打开 Theme Settings > Products（或 Cart）。
  3. 查找类似以下的设置：
    • Enable cart redirection
    • Redirect to cart after add
    • Go to cart after add
  4. 将这些关闭。
  5. 保存并测试。

​
5. 清除浏览器缓存

旧的缓存脚本可能保留之前的购物车行为，导致 Upcart 无法正确加载。
  1. 打开浏览器设置。
  2. 前往 Privacy and Security。
  3. 选择 Clear Browsing Data。
  4. 清除缓存的图片、文件和 Cookie。
  5. 刷新你的商店并测试。

​
6. 使用默认 Shopify 主题测试

如果问题仍然存在，请暂时切换到默认 Shopify 主题（如 Dawn），以排除主题特有的冲突。
  1. 前往 Shopify Admin > Online Store > Themes。
  2. 添加并启用免费主题（如 Dawn）。
  3. 在默认主题上测试 Upcart。
如果 Upcart 在 Dawn 上正常工作，则问题出在你的自定义主题上。请联系你的主题开发者寻求帮助。

​
预防措施

  • 更新后检查配置——主题和应用更新可能会重置或覆盖购物车设置。任何重大更新后，请检查你的购物车类型和应用配置。
  • 安装前测试应用兼容性——添加新的第三方应用之前，请确认它们与 Upcart 兼容。
  • 使用草稿主题进行测试——在发布前先在草稿主题上测试更改，以避免影响正在运行的商店。有关说明，请参阅仅在草稿主题中启用 Upcart。

​
常见问题

不可以，自定义 checkout 页面重定向需要高级编码，Upcart 不直接支持。如有此需求，你需要与开发者合作。
请确保 Upcart 已在 Cart Editor 中激活并发布。同时清除浏览器缓存，确保更新后的行为生效。如果问题仍然存在，请按上述步骤检查第三方应用冲突。
打开该附加组件应用的设置，查找任何自动重定向或”go to cart”配置。如果它们与 Upcart 冲突，请将其禁用。有关应用专属示例，请参阅上文步骤 2。
需要帮助？ 如果你已完成上述所有步骤但问题仍然存在，请通过应用内聊天或发送邮件至 support@upcart.app 联系我们的支持团队。