执行php bin/magento setup:upgrade时出现Magento_GroupedProductSampleData补丁错误

执行php bin/magento setup:upgrade命令时，终端提示无法应用数据补丁Magento\GroupedProductSampleData\Setup\Patch\Data\InstallGroupedProductSampleData，错误出在Magento_GroupedProductSampleData模块，错误截图如下：

可行解决方案： #

• 禁用示例数据模块（推荐，若无需示例数据）
  直接禁用该模块及关联的示例数据模块，执行以下命令：

  php bin/magento module:disable Magento_GroupedProductSampleData Magento_CatalogSampleData Magento_CmsSampleData Magento_ConfigurableProductSampleData Magento_DownloadableSampleData Magento_SalesSampleData Magento_TaxSampleData Magento_ThemeSampleData Magento_UrlRewriteSampleData Magento_WishlistSampleData
  php bin/magento setup:upgrade
  

• 修复补丁依赖与环境

  1. 确认Magento_GroupedProduct等核心模块已启用且安装正常
  2. 清理缓存与生成文件：

     php bin/magento cache:flush
     rm -rf var/generation/ var/di/ var/view_preprocessed/ pub/static/frontend/ pub/static/adminhtml/
     php bin/magento setup:di:compile
     

  3. 重新执行升级命令：

     php bin/magento setup:upgrade
     

• 临时跳过该补丁（应急方案）
  此方法仅用于紧急场景，不建议长期使用：

  1. 登录数据库，找到patch_list表
  2. 执行SQL语句标记补丁为已执行：

     INSERT INTO patch_list (patch_name, patch_status) VALUES ('Magento\GroupedProductSampleData\Setup\Patch\Data\InstallGroupedProductSampleData', 'Applied');
     

  3. 再次运行php bin/magento setup:upgrade

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