适用于 1.1.0 · Build 404。版本号与 Build 共同标识当前程序,后台“系统更新”可查看本机版本、可用新版及更新说明。

选择正确的包

文件 用途
全新部署包 新建站点、首次安装
热更新包 已有站点升级,按后台更新功能及随包说明使用
版本校验文件 核对对应 ZIP 的 SHA-256,确认下载完整
交付报告 查看版本、包信息与验证范围
升级内容说明 查看本次功能变化、修复与注意事项

不要用全新部署包直接覆盖生产站点来代替热更新,也不要混用不同 Build 的文件。

更新前准备

  1. 完整备份数据库、站点配置、上传文件及自定义插件、主题。
  2. 确认备份可恢复,并记录当前版本与备份时间。
  3. 查看更新内容和适配要求,在独立测试环境验证重要扩展。
  4. 确认磁盘空间、站点写权限、出站网络及安全运行组件正常。
  5. 选择业务低峰执行,避免多人同时发起更新。

检查与执行

进入后台 系统更新,检查可用版本并阅读更新内容。确认后使用页面提供的更新操作,更新过程中会显示阶段、进度和日志。

  • 查看下载、校验、应用、迁移等当前阶段。
  • 进度在局部刷新,不需要反复重新提交更新。
  • 页面刷新或短暂断网后,重新进入更新页查看任务状态。
  • 以最终成功/失败结果和升级记录为准,不能只凭进度百分比判断完成。

如果进度暂时不动,先检查最新日志及更新时间。不要重复点击更新、强行覆盖文件或在任务运行中删除运行目录。

强制更新提示

系统会定期检查强制更新,管理员进入后台时会收到对应提示。每 10 分钟检查、零点执行依赖服务器计划任务与正确时区;普通更新不会因为到了零点就自动安装。

请核对站点计划任务已按部署提示注册并正常执行。未配置任务或任务执行失败时,不能假定关掉浏览器后仍会自动完成更新;应及时处理通知并检查更新记录。

更新后核对

  • 当前版本与目标 Build 一致,升级历史显示结果。
  • /home、/store、/login、/register、会员中心与自定义后台入口正常。
  • 站点名称、Logo、主题内容、商品与公告没有被旧缓存覆盖。
  • 支付通知、邮件测试、工单附件及业务任务正常。
  • 运行组件在网页检测中可用;若换过 PHP 版本,执行对应安装命令并复检。

Build 404 的官方下载源为 http://kededl.mercuryseek.cn/。安装组件时优先复制当前安装向导生成的命令,避免沿用旧版本命令中的校验值。

失败与恢复

情况 建议
下载或完整性校验失败 检查网络、包版本与校验文件,使用官方包重试;不要跳过校验
文件无法写入 检查运行用户权限、磁盘空间及安全策略
接口返回页面而非 JSON 检查回源、伪静态、PHP 转发和缓存,详见故障处理
更新接近完成时页面无响应 重新进入更新页查看当前任务和日志,确认任务结束后再决定后续操作
数据迁移失败或页面异常 保留错误时间和日志,避免反复覆盖;联系支持确认恢复方案

后台提供的程序备份回滚不等于数据库恢复。若更新已修改数据结构,应使用同一时间点的数据库、配置与文件备份配套恢复。回滚前也应备份更新后新产生的数据,避免丢失订单或支付记录。

相关文档:部署与维护 · 常见问题 · 版本更新说明

下载文档
原始 Markdown 文件