文档Commerce工具

[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

创建数据迁移计划

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 有经验的
  • 管理员
  • 开发人员

要成功迁移并避免出现问题，您需要彻底规划和测试迁移。

开始之前：请考虑升级

迁移是进行重大更改并为您的站点做好下一级别增长的准备的绝佳时机。 考虑您的新站点是需要设计更多的硬件，还是需要设计更高级的拓扑结构，以及更好的缓存层。

步骤1：查看当前网站上的扩展

  • 您安装了哪些扩展？

  • 您是否确定新网站上是否需要所有这些扩展？ 可能有可以安全移除的旧项目。

  • 是否确定存在Magento 2版本的扩展？ 请访问Commerce Marketplace以查找最新版本，或与扩展提供商联系。

  • 您要迁移扩展中的哪些数据库资产？

步骤2：构建并准备存储以进行迁移

  • 使用至少与现有Magento 1系统匹配的拓扑和设计来设置Magento 2硬件系统

  • 在符合Data Migration Tool系统要求的系统上安装Magento 2.x（包含此版本的所有模块）和

  • 对Data Migration Tool代码进行自定义调整，以防您在迁移期间不需要迁移某些数据(如CMS Pages、Sales Rules)或想要转换Magento自定义。 阅读Data Migration Tool的技术规范以更好地了解如何从内部进行迁移

步骤3：练习

在生产环境中开始迁移之前，最好在测试环境中完成所有迁移步骤。

在此类迁移测试中，请执行以下步骤：

  • 将Magento 1商店复制到暂存服务器

  • 将复制的Magento 1存储完全迁移到Magento 2

  • 彻底测试您的新商店

步骤4：开始迁移

  1. 确保Data Migration Tool具有连接到Magento 1和Magento 2数据库的网络访问权限。 在防火墙中打开相应的端口。

  2. 停止Magento 1.x管理面板中的所有活动（订单管理除外），例如发运、创建发票和贷项通知单。 可以通过调整Data Migration Tool中Delta模式的设置来扩展允许的活动列表。

    note note
    NOTE
    在Magento 2应用商店上线之前，不得恢复这些活动。

  3. 我们建议停止所有Magento 1.x cron作业。

    但是，如果在迁移期间需要运行某些作业，请确保它们不会创建新数据库实体，也不会更改现有实体，以免这些实体无法通过Delta模式进行处理。

    例如，enterprise_salesarchive_archive_orders cron作业将旧订单移动到存档。 在迁移期间运行此作业是安全的，因为增量模式可识别此作业并正确处理归档的订单。

  4. 使用Data Migration Tool迁移设置和网站。

  5. 将Magento 1.x媒体文件复制到Magento 2.x。

    您必须将这些文件从magento1-root/media目录手动复制到magento2-root/pub/media。

  6. 使用Data Migration Tool将数据从Magento 1数据库批量复制到Magento 2数据库。

    如果您的某些扩展包含要迁移的数据，则可能需要安装这些适用于Magento 2的扩展。 如果扩展名在Magento 2数据库中具有不同的结构，请使用随Data Migration Tool提供的映射文件。

  7. 重新索引所有Magento 2.x索引器。 有关详细信息，请参阅配置指南中的​ 管理索引器。

步骤5：根据需要更改迁移的数据

有时，您可能希望在迁移后让Magento 2商店具有不同的目录结构、销售规则和CMS页面。

在进行手动数据更改时，务必要谨慎。 错误会在后续的增量数据迁移步骤中创建错误。

例如，从Magento 2中删除的产品：已在您的Magento 1实时商店中购买且在您的Magento 2商店中不再可用的产品。 在增量模式下运行Data Migration Tool时，传输有关此类购买的数据可能会导致错误。

步骤6：更新增量数据

在迁移数据后，您必须以增量方式捕获已添加到Magento 1商店中的数据更新（例如新订单、审查和客户配置文件中的更改），并使用增量模式将这些更新传输到Magento 2商店。

  • 开始增量迁移；更新将持续运行。 您可以随时按Ctrl+C来停止传输更新。

  • 在此期间，请测试您的Magento 2网站，以尽快发现任何问题。 如果遇到问题，请按Ctrl+C停止增量迁移，并在解决问题后重新启动。

NOTE
如果您同时对Magento 2站点执行测试并运行迁移过程，则可能会显示卷检查警告。 发生这种情况的原因是，在Magento 2中，您创建的实体在Magento 1实例中不存在。

步骤7：上线

现在，您的Magento 2站点已与Magento 1保持同步并且正常运行，请执行以下操作以切换到新站点：

  1. 将Magento 1系统置于维护模式（停机时间开始）。

  2. 在迁移工具命令窗口中按Ctrl+C可停止增量更新。

  3. 启动Magento 2 cron作业。

  4. 在您的Magento 2系统中，重新索引股票索引器。 有关详细信息，请参阅[配置指南]。

  5. 使用您选择的工具，在Magento 2系统中点击页面，以便在客户使用您的店面之前缓存页面。

  6. 对您的Magento 2站点执行任何最终验证。

  7. 更改DNS、负载平衡器等以指向新的生产硬件(DOWNTIME ENDS)。

  8. Magento 2商店现已准备就绪，可供使用。 您和您的客户可以恢复所有活动。

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3