使用UB Data Migration Pro迁移Magento数据时遇Mage2SalesOrder报错

你碰到的这个问题，本质是Magento2的sales_order表中customer_prefix字段的最大长度被限制为32字符，但你的Magento1数据库里存在超过这个长度的前缀值，导致UB迁移工具的校验逻辑触发了报错。下面是几个实用的解决思路：

方法一：直接修正Magento1数据库的问题数据 #

这是最稳妥的方式，先定位问题再处理：

1. 找出过长的前缀记录：在Magento1数据库中执行这条SQL，能快速定位所有违规的订单：

SELECT entity_id, customer_prefix FROM sales_order WHERE LENGTH(customer_prefix) > 32;

2. 根据业务需求处理数据：

   • 如果前缀是有用信息，直接截断到32字符：

   UPDATE sales_order SET customer_prefix = SUBSTRING(customer_prefix, 1, 32) WHERE LENGTH(customer_prefix) > 32;
   

   • 如果前缀是非必需字段，直接清空即可：

   UPDATE sales_order SET customer_prefix = '' WHERE LENGTH(customer_prefix) > 32;
   

   重要提醒：执行更新操作前一定要备份Magento1数据库，避免误操作导致数据丢失！

3. 重新启动UB Data Migration Pro的迁移任务，这个报错应该就能消失了。

方法二：临时调整迁移工具的校验规则（不修改原数据） #

如果你不想改动Magento1的原始数据，可以临时绕过工具的校验逻辑：

1. 找到UB迁移工具中负责SalesOrder字段校验的文件，通常路径类似app/code/Ubertheme/Ubmigration/Model/Migration/Step/SalesOrder/Validator.php（具体路径可能因工具版本略有差异）。
2. 在文件里找到检查customer_prefix长度的代码块，大概是这样：

if (strlen($value) > 32) {
    $this->addError('客户前缀过长（最大长度为32个字符）', $entityId);
}

3. 你可以暂时注释掉这段校验代码，或者把32改成更大的数值（但迁移完成后记得要把Magento2里的过长前缀修正，避免后续出现业务逻辑问题）。
4. 保存文件后重新运行迁移任务即可。

后续注意事项 #

• 迁移完成后务必检查Magento2的订单数据，确保customer_prefix字段符合系统规则，避免影响前端展示或后续的订单操作。
• 如果选择截断前缀，要确认业务场景下是否允许缩短该字段，比如是否会影响订单识别或客户信息的展示。

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