本文约 2,698 字，预计阅读 7 分钟。文中命令与配置均经过实测，可直接参考执行。
引言
每当 WordPress 核心自动更新、或者你手动把程序升级到新版本后，登录后台常常会看到一条醒目的黄色提示：”WordPress 需要更新数据库。点击这里更新。” 很多人会紧张，不知道点了会不会弄坏数据。其实这是 WordPress 的正常流程：新版本的核心代码需要配套调整数据库结构，系统会把当前的数据库版本号存在 wp_options 表的 db_version 选项里，与代码里要求的目标版本比对，发现落后了，就提示你执行升级。正常情况下点一下按钮几十秒就能完成，但有时它卡住、报错、或点了没反应。本文讲清原理，并给出后台向导、WP-CLI、手动执行三种可靠方案。升级前请务必备份数据库和网站文件。
故障原因分析
- 核心程序已更新，数据库结构还没跟上。WordPress 大版本升级时新增了字段、表或索引，
db_version落后于代码要求值，于是触发提示。
- 升级过程中断。点击更新后因浏览器超时、连接中断、内存不足（PHP fatal error）而中途夭折，
db_version没更新成功，下次进后台又提示。
- 数据库用户权限不足。升级需要 ALTER、CREATE 等权限，如果数据库账号只有读写权限，执行结构变更时就会失败。
db_version被手动改坏或工具改错。有人为了消除提示，直接把db_version改成目标值，结果跳过了真正的结构升级，导致后续功能异常。
- 多站点或缓存干扰。多站点网络需要单独跑网络更新；对象缓存（如 Redis、Memcached）缓存了旧的数据库版本状态，导致提示反复出现。
分步解决方案
第零步：备份，再升级
在 phpMyAdmin 里导出完整数据库，同时对网站目录（特别是 wp-content）做一份文件备份。升级涉及结构变更，出问题时靠备份回退。建议顺便记录当前 wp_options 里的 db_version：
SELECT option_name, option_value FROM wp_options WHERE option_name = 'db_version';方法一：用后台更新向导（最简单）
- 登录 WordPress 后台，看到”需要更新数据库”的提示。
- 点击”更新 WordPress 数据库”按钮（或访问
https://你的域名/wp-admin/upgrade.php）。 - 等待页面执行完成，显示”数据库已成功更新”即成功。
- 若一直转圈或报错，按下面的方法换命令行执行。
注意：如果正在使用页面缓存或 CDN，升级期间建议先临时关闭，避免缓存住旧的提示页。
方法二：用 WP-CLI 升级（有 SSH 时推荐，可控性最好）
进入网站根目录后执行：
wp core update-db它会自动比对并执行所需的数据库结构升级，输出每个步骤的结果。升级完再确认版本：
wp option get db_version如果是多站点网络，使用：
wp core update-db --networkWP-CLI 的好处是能看到详细报错，哪一步失败一目了然，比后台按钮透明得多。
方法三：手动排查与修复（向导失败时）
第 1 步，确认权限。用数据库账号执行一条无害的测试：
SELECT CURRENT_USER();
SHOW GRANTS FOR CURRENT_USER();看返回的授权里有没有 ALTER、CREATE、INDEX 等权限，没有就找主机商补授：
GRANT ALTER, CREATE, INDEX, DROP ON 你的数据库名.* TO '你的用户'@'localhost';
FLUSH PRIVILEGES;第 2 步，清缓存再重试。清空对象缓存和页面缓存（Redis/Memcached 客户端 flush，或插件里一键清理），再访问 /wp-admin/upgrade.php。
第 3 步，临时扩大执行资源。升级有时因超时或内存不足失败，可在 wp-config.php 里临时加入：
define( 'WP_MEMORY_LIMIT', '256M' );
set_time_limit( 300 );改完重试升级，成功后可视情况保留内存设置。
第 4 步，查看真实报错。开启调试日志定位问题，在 wp-config.php 里设置：
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );然后访问 /wp-content/debug.log 查看具体错误，按提示针对性处理（常见是某张表缺字段、某插件与新版不兼容）。
第 5 步，切勿盲改 db_version。有人为了消掉提示，直接把 db_version 改成代码要求的值，这会跳过真正的结构升级，后续可能出现数据错乱。只有在确认结构已经完整、只是版本号残留错误时，才可谨慎修正：
UPDATE wp_options SET option_value = '目标版本号' WHERE option_name = 'db_version';这一步务必先备份，并确保你没有绕过任何必要的升级步骤。
第末步：验证
升级完成后，登录后台确认黄色提示消失，发布一篇测试文章、上传一张图片、打开一个插件设置页，确认都正常；再用 wp core verify-checksums 或核心文件比对确认程序完整。
常见踩坑点
- 不备份就升级。结构变更出错难以回退，备份是前提。
- 直接点更新后刷新页面。中途刷新可能中断升级，让它自己跑完。
- 数据库用户权限不够。只有 SELECT/INSERT 权限是升不了结构的。
- 手动把 db_version 改成目标值。跳过结构升级，后患无穷。
- 清缓存不彻底。对象缓存导致提示反复出现。
- 多站点只升级了子站。网络模式要用
--network统一升级。
总结
后台提示”WordPress 需要更新数据库”，本质是代码版本与数据库结构版本 db_version 不一致，需要执行一次结构升级。最省事的是点后台更新按钮，最可控的是用 wp core update-db，升级失败时则从数据库权限、缓存、内存超时和调试日志几个方向排查。请牢记：WordPress数据库升级前一定先备份，也绝不要为了消除提示而盲目篡改 db_version，那会让结构升级被跳过。按本文步骤操作，这类升级通常几分钟就能稳稳完成。
