回滚部署版本

当新版本部署后出现异常，或需要把线上服务恢复到一个已经验证过的部署版本时，可以在 部署历史 中选择目标记录执行回滚。平台会使用该记录对应的版本重新执行打包、构建和部署；部署成功后，线上运行版本切换为所选的回滚版本。

注意

部署历史中的 回滚 是生产操作。单击后会直接开始重新部署，不会先恢复当前项目工作区代码，也不需要在对话历史中单击 回到该版本。新部署成功前，线上仍运行原版本；部署成功后，线上才切换为所选版本。

操作前确认

• 记录当前线上部署版本、运行地址和异常现象。
• 确认目标部署记录曾通过生产验证，并核对版本号、提交标识、部署时间和状态。
• 评估数据库结构、生产数据、环境变量和对象存储是否与目标版本兼容。

进入回滚入口

1. 打开需要回滚的 AI 编程项目，单击顶部的 新标签页；在页面的 托管 区域中单击 部署，进入部署运维页面。

图 1：第 1 步，打开“新标签页”，在“托管”区域中单击“部署”。

2. 进入 总览 后，在 部署历史 中找到目标记录，核对版本和部署时间，再单击记录右侧的 更多操作（…）。
3. 在展开的菜单中单击 回滚。

图 2：第 2 步，在“部署历史”中展开目标记录右侧的“…”；第 3 步，在菜单中单击“回滚”。

等待回滚部署完成

1. 单击 回滚 后，平台会立即开始重新部署目标版本。
2. 在部署进度中依次查看 打包、构建、部署 三个阶段和实时日志。
3. 如果部署失败，根据失败阶段和日志定位问题；部署未成功时，原线上版本不会被替换。
4. 三个阶段全部完成后，确认页面显示 部署成功。
5. 打开页面提供的生产访问地址，复测核心流程。
6. 返回 总览，核对生产环境中的版本、部署时间和运行地址，并确认部署历史已新增本次回滚记录。

图 3：第 4 步，确认“打包、构建、部署”均已完成，再打开访问地址验收。

回滚后验证

• 应用可以正常打开，核心页面和交互可用。
• 关键接口、数据库读写和文件访问正常。
• 运行日志中没有持续出现错误。
• 页面提供 Trace 时，可通过请求标识继续检查异常或慢请求。

注意事项

• 部署回滚针对生产部署记录，不等同于恢复当前项目工作区代码。
• 数据库结构和生产数据不会跟随部署版本自动回滚，需要单独制定恢复方案。
• 环境变量和对象存储通常沿用当前生产配置，回滚前必须核对兼容性。
• 移动应用涉及安装包时，需要根据回滚后的部署版本重新生成并验证安装包。
• 回滚部署失败时，线上继续运行原部署版本；只有目标版本重新部署成功后，线上版本才完成回滚。