修改wp-admin常规设置后WordPress站点崩溃该如何排查解决？

故障表现 #

对正常运行的WordPress站点执行以下任意一项操作后，站点会出现不可逆崩溃：

• 修改「设置」→「站点语言」
• 修改「设置」→「任何人可注册」

崩溃后即使改回原设置，故障依旧存在：自定义主题失效回退为空白默认主题，站点仅页头页脚显示少量文本，其余区域为空白。故障效果如下：

可能的根本原因 #

• 自定义开发的注册登录功能代码绑定了option_update钩子，修改对应设置时触发代码中的致命错误（如未定义函数调用、逻辑判断异常）
• 当前主题/插件中存在对站点语言、用户注册配置的依赖判断逻辑，配置值变更后触发兼容性报错
• 修改设置时写入wp_options表的序列化数据损坏，导致主题路径、站点配置读取异常
• 站点目录权限配置错误，修改语言时生成翻译文件失败，或读取主题目录文件无权限
• 站点缓存规则异常，修改配置后生成了错误的缓存文件，且缓存未随配置回退自动更新

排查步骤 #

1. 开启WordPress调试模式：编辑站点根目录wp-config.php文件，将WP_DEBUG常量值改为true，新增define( 'WP_DEBUG_LOG', true );配置，复现故障后查看wp-content/debug.log文件中的致命错误日志，定位报错的文件与代码行
2. 临时注释所有本次开发新增的自定义代码（主题functions.php新增代码、自定义插件代码），再次修改对应设置验证故障是否消失
3. 临时切换到WordPress官方默认主题（如Twenty Twenty-Four），修改设置验证故障是否消失，判断是否为当前自定义主题导致
4. 禁用所有非必要插件，逐一个启用插件并测试修改配置，定位是否为插件冲突导致
5. 登录数据库管理工具，检查wp_options表中template、stylesheet字段值是否为当前使用的主题目录名，检查WPLANG、users_can_register字段值是否符合预期，确认是否存在序列化数据损坏问题
6. 检查站点目录权限：wp-content、wp-content/themes、wp-content/languages目录权限设置为755，对应目录下文件权限设置为644，确保Web运行用户有读写权限

修复方案 #

• 若为自定义代码逻辑错误：根据调试日志定位的报错位置，修复代码问题，比如新增配置值存在性判断、避免在配置加载完成前调用WordPress核心函数
• 若为主题兼容性问题：修复主题中绑定的pre_update_option_{option_name}钩子逻辑，或替换为兼容的主题版本
• 若为数据库配置损坏：手动修正wp_options表中对应字段的异常值，template与stylesheet字段填入当前主题的文件夹名即可恢复主题加载
• 若为权限/缓存问题：修正目录权限后，清空站点所有缓存（WP内置缓存、服务器缓存、CDN缓存）即可恢复

内容的提问来源于stack exchange，提问作者Mihail_OLARU