# 升级迁移问题排查与解决手册

在进行 EOS 平台版本升级或将应用从开发环境迁移到生产环境时，遇到功能异常、报错等问题，请参考以下排查指南。

# 现象一：升级后核心功能报错或异常

典型表现：

常见原因：

解决步骤：

核对升级路线和补丁：
- 严格遵循官方升级指南。例如，从 8.3.0 升级到 8.3.3，通常需要先升级到 8.3.1，再到 8.3.2，最后到 8.3.3。
- 检查是否已安装针对当前版本的 合集补丁，合集补丁通常包含多个重要修复。
检查并执行数据库升级脚本：
- 在数据库中找到版本记录表（如果有），或对比新旧版本数据库脚本，确认所有表结构变更（ALTER TABLE）和新增数据（INSERT）都已执行。
- 关键数据迁移：例如，从 8.3.2 升级到 8.3.3 时，需要手动将 bfp_message_* 系列表的数据同步到新的 afc_message_* 系列表中。
对比配置文件：
- 使用对比工具，对比新旧版本的 application.properties、user-config.xml 等核心配置文件，将新版本的配置项（如 SSO 相关、新功能开关）合并到旧文件中。
- 特别注意检查 eos.profiles.active 是否为 prod（生产环境）。
清理浏览器和应用缓存：
- 升级后，务必清理浏览器缓存，并重启 Nginx 以加载最新的前端资源。
- 删除应用的 work 和 work_temp 目录，然后重启应用，确保所有编译后的资源都是最新的。

典型表现：

常见原因：

解决步骤：

优先使用基线包进行迁移：
- 相比于构件包，基线包（全量导入）是更推荐的迁移方式。它包含更完整的资源信息和依赖关系，能更好地保证环境一致性。
迁移后执行“编译”或“提取”操作：
- 对于表单/视图：如果导入后显示异常，可以在目标环境的开发中心（如果允许开放）找到对应构件包，右键选择“批量编译”或逐一打开资源并保存，强制其重新生成运行态代码。
- 对于流程：如果流程行为异常，可以在低开 IDE 中右键点击该流程，选择“提取”，将 BPS 中的最新流程定义同步到低开模型中。
清理 BPS 流程定义缓存：
- 如果已删除的流程依然可见，请登录 流程中心-引擎管理-资源管理，在列表中找到并手动删除对应的流程定义资源。这将清除 BPS 侧的缓存。
数据权限和角色重新授权：
- 迁移后，原环境中配置的数据权限、角色与菜单的关联关系可能因 ID 变化而丢失。需要在新环境中重新进行授权配置。

典型表现：

常见原因：

解决步骤：

恢复并检查 SSO 配置：
- 从旧版本备份中恢复 application-afc.properties 或 application.properties 中的 SSO 相关配置。
- 对比新版本文档，确认是否有新增的必填配置项（例如，8.3.3 的消息中心可能需要额外配置连接器）。
检查白名单和拦截器：
- 新版本可能增加了对某些接口的拦截。检查 user-config.xml 中的白名单配置，确保 SSO 回调地址、第三方消息推送接口等已被加入白名单。
升级第三方集成 SDK/补丁：
- 针对企业微信、钉钉等集成，确认是否有专门针对新版本的适配补丁。例如，8.3.3 版本有专门的补丁用于修复企业微信登录跳转问题。
- 如果在升级后消息发送失败，检查 application-job.properties 等文件中 xxl.job.accessToken 的配置是否正确。