更新与维护

更新前先备份

主题更新前至少备份：

不要直接修改 wp-content/themes/zibll 里的主题核心文件。主题更新会覆盖核心文件，后续排查也很难判断是官方代码、旧版本残留，还是自定义改动造成的问题。

更新前检查

更新前先确认：

1. 授权域名和当前访问域名一致。
2. 服务器能访问更新源。
3. PHP 扩展完整，尤其是 curl、openssl、zip。
4. wp-content/themes、wp-content/upgrade 可写。
5. PHP 超时和内存限制足够。
6. 当前没有正在进行的大流量活动或支付高峰。
7. 有可用备份，并且知道如何恢复。

如果站点启用了 CDN 或安全防护，更新前可以临时降低拦截强度，避免更新包下载、解压或后台 Ajax 被拦截。

在线更新流程

正常更新建议：

1. 备份数据库和文件。
2. 在低峰期进入 WordPress 后台更新。
3. 等待更新完成，不要中途刷新页面。
4. 更新完成后清理缓存。
5. 打开首页、文章页、用户中心、支付页、移动端菜单。
6. 查看 PHP 错误日志。
7. 如果有对象缓存，清理 Redis 或对象缓存插件。

更新后前台样式错乱，大多数是旧 CSS/JS 缓存。先清浏览器、缓存插件、服务器缓存、CDN，再判断是否是真正的兼容问题。

授权和域名

授权异常时不要只看后台提示，要确认这些细节：

修改域名、迁移服务器、开启 CDN 后，如果授权状态异常，先清理缓存并确认当前访问域名就是授权域名。

更新失败

常见原因：

如果 WordPress 提示“正在执行例行维护”，检查站点根目录是否残留 .maintenance 文件。确认更新进程已经结束后再删除它。

样式错乱

更新后样式错乱按这个顺序处理：

1. 强制刷新浏览器。
2. 清理 WordPress 缓存插件。
3. 清理对象缓存。
4. 清理 Nginx/OpenLiteSpeed 缓存。
5. 清理 CDN 缓存。
6. 暂停 CSS/JS 合并压缩。
7. 检查主题静态资源是否 404。
8. 检查是否有子主题模板覆盖旧结构。

如果只有移动端异常，重点检查移动端缓存规则、JS 延迟加载、菜单脚本和浏览器控制台报错。

回滚处理

更新后出现严重问题时：

1. 先切维护页或暂停 CDN 回源，避免用户继续触发错误。
2. 保留错误日志，不要马上清空。
3. 恢复更新前的主题文件。
4. 必要时恢复数据库。
5. 清理所有缓存。
6. 重新验证登录、支付、用户中心和核心页面。
7. 记录问题版本、报错信息、插件列表和服务器环境。

如果数据库已经被新版迁移过，只回滚主题文件可能不够。恢复前要确认备份时间点一致。

自定义代码维护

后台自定义 CSS、JavaScript、头部/底部 HTML 和 PHP 扩展的放置边界见 自定义代码与安全注入。更新前应同时备份数据库中的自定义代码配置和插件、子主题里的 PHP 扩展。

站点有自定义功能时，建议这样管理：

扩展功能应优先挂 WordPress Hook、主题公开 Hook、Ajax action 和模板覆盖点。只有确认主题没有合适入口时，才考虑更重的改造方式。

定期维护

建议固定做：

1. 每周检查备份是否成功。
2. 每月抽查一次备份恢复能力。
3. 定期清理过期缓存和无用插件。
4. 更新前阅读版本说明。
5. 检查错误日志是否持续出现同类警告。
6. 检查支付、邮件、短信、验证码接口是否仍可用。
7. 检查 CDN 证书、源站证书和回源协议。

维护不是只在出问题时处理。登录、支付、验证码、邮件这些链路，最好定期用真实流程跑一遍。

参考来源

本页吸收了子比官网在线更新、升级常见问题、授权域名和常见故障公开教程，并结合 WordPress 更新、缓存、权限与主题扩展维护经验整理。