Hybris版本升级数据库迁移相关问题求助（1811→2105）

一、数据未迁移引发的功能异常 #

从Hybris 1811到2105属于跨多个大版本的升级，期间平台有大量数据模型变更（包括表结构调整、新字段添加、枚举值更新、类型系统扩展修改等）。选择no migrate data会直接导致旧数据结构与新代码逻辑不兼容，这大概率是部分功能失效的核心原因。

验证与修复步骤： #

• 检查HAC的Platform Update页面，查看未执行的data migration scripts和update running system任务，这些是版本升级的强制步骤。
• 查看应用服务器日志（如hybris/log/tomcat/catalina.out），定位SQL报错（找不到列/表、数据类型不匹配）或数据访问异常，确认是结构不兼容问题。
• 备份当前QAS环境的数据库与Hybris实例后，重新执行平台更新：
  1. 在HAC中勾选migrate data选项，同时勾选update running system、create essential data等升级指南要求的任务。
  2. 若HAC操作仍有问题，使用命令行执行：ant updatesystem -Dmigrate.data=true，确保迁移脚本全量执行。

二、HAC更新操作冻结处理 #

更新冻结通常由数据库锁冲突、资源不足或脚本执行异常导致，可按以下步骤排查：

处理步骤： #

1. 强制释放数据库锁：
   • 登录数据库，查询并删除LOCKS表中的所有记录（Hybris的全局锁表）。
   • 排查并终止数据库中长时间运行的事务，避免锁占用。
2. 检查服务器资源：
   • 确认QAS环境的CPU、内存满足Hybris 2105的最低要求（建议堆内存≥8G），若资源不足需扩容后重试。
3. 命令行执行更新：
   • 跳过HAC界面，用命令行执行：ant updatesystem -Dmigrate.data=true -Dupdate.verbose=true，通过详细日志定位卡死的具体步骤。
4. 排查更新日志：
   • 查看hybris/log/update.log，找到报错的迁移脚本或任务，针对性修复（如手动调整异常数据、修正脚本语法）。

额外注意事项： #

• 升级前必须严格遵循官方Hybris 1811 to 2105 Upgrade Guide，逐一落实每个版本间的迁移要求。
• QAS环境升级前务必做全量备份，防止操作失误导致数据丢失。
• 本地升级成功不代表QAS环境可直接部署，需确保QAS环境的配置、数据与本地环境的差异已被覆盖。

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