将WordPress迁移至本地域名后页面空白问题求助

1. 开启调试模式显示错误详情 #

空白页大多是PHP致命错误但未输出导致的，在wp-config.php中添加/修改以下代码强制显示错误：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', true );
@ini_set( 'display_errors', 1 );

刷新页面后就能看到具体错误提示，比如插件/主题的PHP版本兼容性问题、函数调用错误等。

2. 修正站点文件与目录权限 #

Ubuntu下Nginx默认以www-data用户运行，确保站点目录权限匹配：

• 执行命令统一修正权限：

sudo chown -R www-data:www-data /var/www/site.local
sudo find /var/www/site.local -type d -exec chmod 755 {} \;
sudo find /var/www/site.local -type f -exec chmod 644 {} \;

重点确认wp-content/uploads这类需要写入权限的目录，权限设为755即可。

3. 修复数据库序列化数据问题 #

WordPress部分数据库字段用序列化格式存储，远程域名和本地site.local长度不一致会导致序列化失效，引发致命错误：

• 除了修改options表的siteurl和home字段，还要批量替换所有含旧域名的内容（替换your_prefix为你的表前缀）：

UPDATE your_prefix_options SET option_value = REPLACE(option_value, '旧远程域名', 'site.local');
UPDATE your_posts SET post_content = REPLACE(post_content, '旧远程域名', 'site.local');
UPDATE your_postmeta SET meta_value = REPLACE(meta_value, '旧远程域名', 'site.local');

如果有自定义字段或其他表存了旧URL，也要对应执行替换。

4. 排查插件/主题兼容性冲突 #

空白页可能是第三方插件/主题与本地PHP8.3不兼容导致：

• 重命名wp-content/plugins为wp-content/plugins_disabled，强制禁用所有插件，刷新页面看是否恢复正常。
• 若恢复，再逐个恢复插件目录名称，找出冲突插件后更新或替换兼容版本。
• 同理，重命名当前主题目录（如wp-content/themes/yourtheme为yourtheme_disabled），WordPress会自动切换到默认主题，排查主题是否存在问题。

5. 查看服务器日志定位问题 #

如果调试模式无输出，检查Nginx和PHP的错误日志：

• 查看Nginx错误日志：

tail -f /var/log/nginx/error.log

• 查看PHP-FPM错误日志：

tail -f /var/log/php8.3-fpm.log

日志会记录具体错误原因，比如文件缺失、权限不足、PHP扩展缺失等。

6. 检查PHP扩展是否齐全 #

远程站点可能依赖某些PHP扩展，本地未安装会引发错误：

• 查看当前已安装的PHP扩展：

php -m

• 对比远程站点的PHP扩展列表（可通过远程phpinfo()页面查看），若缺失mysqli、gd、curl、mbstring等，执行安装命令：

sudo apt install php8.3-mysqli php8.3-gd php8.3-curl php8.3-mbstring

安装后重启PHP-FPM：

sudo systemctl restart php8.3-fpm

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