WordPress 7.1 升级指南：兼容性检查、备份与回滚

WordPress 7.1 已于 2026 年 8 月 19 日发布。对生产站点来说，升级前真正需要确认的不是后台有没有出现“立即更新”按钮，而是服务器环境、主题插件、编辑器扩展和业务流程能否在 7.1 下继续工作，以及数据库升级后是否有一套实际可执行的恢复方案。

本文面向自托管 WordPress 单站与常规企业站。Multisite、WooCommerce、会员、付费下载和高频投稿站点还要把网络数据库、订单、用户写入和外部服务回调纳入维护窗口。以下步骤是升级决策与回滚框架，不等于某个插件或主题已经通过兼容认证。

WordPress 7.1 升级前，先检查哪些兼容性变化

服务器环境：最低可运行不等于适合继续使用

截至 2026 年 8 月 22 日核对，WordPress 7.1 的最低要求为 PHP 7.4、MySQL 5.5.5 或 MariaDB 5.5.5；官方 Hosting Team 同时确认 7.1 与 PHP 7.4 至 8.5 兼容。不过，PHP 7.4、8.0 和 8.1 已经结束上游安全支持，保留兼容只是为了旧站过渡，不能据此判断它们仍是合适的生产环境。

新安装环境的官方建议更高：PHP 8.4/8.5、MySQL 8.4，或 MariaDB 10.11/11.4/11.8。现有站点不必为了升级核心而在同一个维护窗口里同时跨越 PHP、数据库和 WordPress 三层版本；把变量拆开，在 staging 逐项升级和验证，通常更容易定位问题。这是运维建议，不是 WordPress 强制要求。

进入“工具 → 站点健康 → 信息”，记录 WordPress、PHP、数据库、活动主题、活动插件、文件权限和目录大小。命令行环境还可以先保存一份组件清单：

wp core version
wp plugin list --fields=name,status,version,update_version,auto_update
wp theme list --fields=name,status,version,update_version,auto_update
wp core verify-checksums --include-root --version=$(wp core version)

verify-checksums 用于核对核心文件是否与当前版本的官方校验值一致；它不能替代恶意代码排查，也不会验证商业插件和自定义代码。执行命令前应确认当前目录确实是目标站点根目录。

插件与主题：重点测试编辑器 iframe 和 jQuery UI 依赖

WordPress 7.1 完成了文章编辑器的 iframe 化，即使站点注册了传统 Meta Box，编辑画布也会运行在 iframe 中。依赖跨文档查找 DOM、向编辑画布直接注入 CSS/JavaScript，或仍使用较旧 Block API 的自定义区块和编辑器扩展，是本次最值得优先测试的对象。

7.1 还把内置 jQuery UI 更新到 1.14.2。使用拖拽、排序、日期选择、弹窗或自定义后台组件的插件，可能依赖旧版行为或样式。兼容检查不能只看插件详情页上的“兼容至”字段；至少要在 staging 中打开编辑器、切换区块、保存草稿、操作 Meta Box，并走完相关后台组件的真实流程。

建议先把插件分成三组：直接影响登录、缓存、安全和备份的基础设施插件；影响编辑器、表单、商店和会员的业务插件；只提供短代码、小组件或样式的展示插件。先验证前两组，并记录每个组件的当前版本、更新版本、作者兼容说明和替代方案。停止维护、来源不明或长期没有兼容声明的扩展，应视为升级风险，而不是默认通过。

备份必须同时覆盖数据库与文件，并先验证能否恢复

WordPress 官方备份文档明确区分数据库与站点文件：数据库包含文章、评论、用户、设置和大量插件数据；文件则包括核心、主题、插件、上传内容、wp-config.php、.htaccess 及服务器自定义文件。只下载 wp-content，或者只导出 SQL，都不构成完整恢复集。

1. 先冻结或降低写入：高频订单、注册、评论和表单站点应进入维护窗口，避免备份完成后继续产生难以合并的新数据。
2. 先导出数据库：使用主机面板、phpMyAdmin 或已配置好的 WP-CLI。命令行示例为 wp db export before-wordpress-71.sql --add-drop-table。
3. 再备份文件：至少覆盖完整 wp-content、wp-config.php、根目录服务器规则和自定义文件；如果核心目录有历史手改，必须单独记录，因为官方更新会覆盖核心文件。
4. 形成同一时间点的备份集：数据库和文件应使用一致的站点标识与时间戳，并复制到站外位置。不要只依赖仍放在当前服务器上的压缩包。
5. 验证备份：检查 SQL 能否解压和读取、压缩包是否完整、恢复凭据与入口是否可用。业务关键站点应在隔离环境实际恢复一次，而不是等故障时第一次尝试。

需要特别注意：WordPress 核心升级可能触发数据库结构更新。此时“重新上传旧版核心文件”并不能保证回到升级前状态，甚至可能造成旧代码读取新数据库结构。完整回滚必须把旧文件与同一时间点的旧数据库视为一个整体。

先在 staging 执行一次完整升级演练

staging 应尽量复制生产站的 PHP、数据库版本、Web 服务器、对象缓存、CDN 规则、主题插件及关键数据结构，并阻止真实邮件、支付、Webhook 和搜索索引写入外部生产服务。仅安装一个空白 WordPress 7.1，不能证明现有站点兼容。

升级顺序与观察点

1. 从生产备份恢复 staging，确认未升级副本可以正常登录、编辑和访问前台。
2. 记录浏览器控制台、PHP 日志与 wp-content/debug.log 的基线。WP_DEBUG 与 WP_DEBUG_LOG 只在本地或 staging 开启，不建议在生产前台显示错误。
3. 先更新已有插件和主题，再升级 WordPress 核心；每批更新之间保留清晰的时间点与日志，避免所有组件同时变化后无法定位冲突。
4. 访问 /wp-admin 并完成可能出现的数据库升级。使用 WP-CLI 时，wp core update-db --dry-run 可先比较数据库版本；确认后再运行 wp core update-db。Multisite 需要按网络范围处理。
5. 清理页面缓存、对象缓存、浏览器缓存和 CDN 缓存，再执行回归测试。

回归测试不要只检查首页

• 编辑器：新建草稿、打开旧文章、插入常用区块、操作自定义区块和 Meta Box、保存并预览。
• 前台：首页、文章页、分类页、搜索、404、导航、响应式布局和登录退出。
• 业务：表单提交、邮件发送、会员注册、权限控制、购物车、结账、支付回调或付费下载；测试环境不要产生真实交易。
• 媒体与任务：上传图片、生成缩略图、计划文章、WP-Cron、REST API、Webhook 和第三方同步。
• 性能与错误：比较主要页面响应、PHP 致命错误、弃用提示、JavaScript 控制台错误和重复 4xx/5xx。

如果错误只在 7.1 出现，应先按插件、主题、缓存层和自定义代码逐项隔离，而不是把所有异常都归因于 WordPress 核心。保留可复现步骤、日志时间、浏览器与 PHP 版本，才能让开发者或插件作者有效定位问题。

生产升级与回滚：先定义触发条件，再进入维护窗口

在生产操作前写下回滚触发条件，例如：后台无法登录、编辑器无法保存、首页持续 5xx、订单或注册流程失败、关键 API 中断，或数据库升级未完成。轻微样式错位、缓存未刷新和单个非关键组件告警，通常应先排查缓存与扩展；涉及数据写入错误或核心业务中断，则不应长时间边运行边观察。

1. 发布维护通知，暂停或记录订单、评论、注册等新写入。
2. 创建最后一份数据库与文件备份，并确认远端副本可访问。
3. 按 staging 已验证的顺序更新插件、主题和 WordPress 7.1，不临时加入未经演练的 PHP 或数据库大版本变更。
4. 完成数据库升级、缓存清理和关键路径冒烟测试，持续观察错误日志与业务监控。
5. 验证通过后解除维护；保留升级前备份和变更记录，不要立即删除。

需要回滚时，按“旧文件 → 旧数据库”的顺序恢复

1. 重新进入维护状态，停止新写入并记录升级后已经产生的订单、用户、评论或表单数据。
2. 恢复升级前的 WordPress 文件集，尤其是原主题、插件、自定义代码和配置。
3. 导入与这些旧文件同一时间点的数据库备份。若数据库凭据或路径发生变化，同步核对 wp-config.php。
4. 清理对象缓存、页面缓存、PHP OPcache 和 CDN 缓存，检查固定链接与文件权限。
5. 重新测试登录、前台、编辑器和关键业务，并把升级后新产生的数据按业务规则人工补录或合并。

数据库回滚会覆盖升级后产生的写入，因此“先停写、再备份、尽快决策”比单纯追求回滚速度更重要。对订单密集或多人协作站点，如果不能接受数据丢失，应使用具备增量备份、事务级恢复或专业迁移能力的主机与运维方案，而不是直接导入一份旧 SQL。

升级完成后的检查与资料入口

升级完成后再次记录核心、主题、插件、PHP 和数据库版本，检查“工具 → 站点健康”、计划任务、缓存、备份任务和外部监控。若 staging 中开启了调试日志，完成排查后应关闭调试显示并妥善处理日志文件，避免把路径、查询或用户数据暴露给访客。

本文于 2026 年 8 月 22 日核对。WordPress 7.1 已正式发布；服务器兼容范围、插件主题状态和主机恢复方式仍可能变化，实际升级前应再次查看官方资料与各扩展维护者说明。

• WordPress 版本发布归档：https://wordpress.org/download/releases/
• WordPress 7.1 Field Guide：https://make.wordpress.org/core/2026/08/05/wordpress-7-1-field-guide/
• WordPress 7.1 服务器兼容性：https://make.wordpress.org/hosting/handbook/compatibility/version/7-1/
• WordPress 官方更新说明：https://wordpress.org/documentation/article/updating-wordpress/
• WordPress 官方备份文档：https://developer.wordpress.org/advanced-administration/security/backup/
• WordPress 调试文档：https://developer.wordpress.org/advanced-administration/debug/debug-wordpress/
• WP-CLI 数据库导出：https://developer.wordpress.org/cli/commands/db/export/