本文详解 magento 2.4.4 安装带样本数据时出现 “rolled back transaction has not been completed correctly” 错误的根本原因、精准定位方法及安全修复方案，适用于 wamp/xampp 环境下的本地开发调试。
本文详解 magento 2.4.4 安装带样本数据时出现 “rolled back transaction has not been completed correctly” 错误的根本原因、精准定位方法及安全修复方案，适用于 wamp/xampp 环境下的本地开发调试。
在 Magento 2.4.4 中启用 Sample Data 安装时，常见报错如下：
Unable to apply data patch Magento\GroupedProductSampleData\Setup\Patch\Data\InstallGroupedProductSampleData for module Magento_GroupedProductSampleData. Original exception message: Rolled back transaction has not been completed correctly.
该错误并非由 CSV 文件损坏直接导致（尽管早期社区常误判），而是源于事务回滚（rollback）过程中异常未被正确捕获或处理——尤其在第三方模块干扰、数据库约束冲突或 PHP 异常未透出时，Magento 默认静默吞掉关键堆栈信息，致使问题难以定位。
? 关键诊断：暴露真实异常源头
Magento 框架在 vendor/magento/framework/DB/Adapter/Pdo/Mysql.php 的 rollback() 方法中对异常做了简化处理。为获取完整上下文，需临时增强日志输出（仅用于开发环境）：
- 打开文件：vendor/magento/framework/DB/Adapter/Pdo/Mysql.php
- 定位 public function rollback() 方法（通常在第 1200 行左右）
- 找到 else 分支中类似以下逻辑（注意不同版本略有差异）：
} else {
// 原有代码可能为空或仅抛出泛化异常
throw new \Exception('Rolled back transaction has not been completed correctly.');
}
✅ 修改建议（临时调试用）：
在 else 块内添加追踪输出，强制打印完整异常堆栈：
} else {
// ⚠️ 仅限开发环境！部署前务必删除或注释此行
error_log((new \Exception())->getTraceAsString());
throw new \Exception('Rolled back transaction has not been completed correctly.');
}
? 提示：使用 error_log() 而非 echo，避免破坏 JSON/AJAX 响应；查看 php_error.log 或 Wamp 控制台日志即可捕获真实异常路径（如某第三方模块的 afterSave 观察者抛出 UniqueConstraintViolationException）。
? 常见根本原因与修复策略
| 类型 | 典型表现 | 推荐操作 |
|---|---|---|
| 第三方模块冲突 | 错误堆栈指向 app/code/Vendor/Module/... | 禁用可疑模块：bin/magento module:disable Vendor_ModuleName，再重试 bin/magento setup:upgrade --keep-generated |
| MySQL 严格模式不兼容 | Wamp 默认启用 STRICT_TRANS_TABLES | 在 my.ini 中临时注释 sql_mode = "STRICT_TRANS_TABLES,..."，重启 MySQL 并清缓存 |
| PHP 内存/超时限制不足 | 安装卡在 InstallGroupedProductSampleData | 增加 php.ini：memory_limit=4G、max_execution_time=3600，重启 Apache |
| Sample Data 版本不匹配 | 下载的 .zip 与核心 Magento 版本 minor 不一致 | 务必从 Magento Tech Resources 下载 完全匹配的 magento-2.4.4.zip（含 sample data），勿混用 composer create-project 生成的版本 |
✅ 安全安装流程（推荐）
# 1. 清理环境（确保干净） rm -rf var/cache/* var/page_cache/* var/generated/* pub/static/* bin/magento cache:clean # 2. 禁用所有第三方模块（仅保留 Magento 原生） bin/magento module:status --enabled | grep -v "Magento_" | xargs bin/magento module:disable --force # 3. 启用 Sample Data 并安装 bin/magento sampledata:deploy bin/magento setup:upgrade # 4. 静态资源编译（可选，但推荐） bin/magento setup:static-content:deploy -f en_US
⚠️ 重要注意事项
- 切勿在生产环境修改 Mysql.php：上述 error_log 行仅为本地调试，上线前必须移除；
- 避免直接编辑 vendor 文件：长期解决方案是通过插件（Plugin）拦截 rollback()，或提交 issue 至对应第三方模块仓库；
- Wamp 兼容性提醒：Magento 2.4.4 官方要求 PHP 8.1+，请确认 Wamp 使用的是 PHP 8.1.x（非 8.0 或 8.2），并启用 pdo_mysql, gd, xsl, intl 等扩展；
- 若问题持续存在，可启用数据库查询日志辅助分析：
# 在 MySQL 中执行（临时） SET GLOBAL general_log = 'ON'; SET GLOBAL general_log_file = 'C:/wamp64/logs/mysql_query.log';
通过精准定位异常源头 + 排查模块/配置冲突，90% 以上的 Rolled back transaction 错误均可高效解决。记住：Magento 的样本数据安装本质是批量执行数据补丁（Patch），任何环节的静默失败都会触发事务回滚——而暴露它，是修复的第一步。
