WordPress远程站点报500错误但本地运行正常故障排查求助

排查方案 #

针对sodium_compat/Compat.php文件存在却提示找不到的问题 #

• 核查文件权限与所有者：Linux环境下WordPress核心文件推荐权限为644，目录权限为755，文件所有者需与Web服务运行用户（常见为www-data、apache、nginx）保持一致。FTP上传的文件经常出现权限或所有者不匹配的问题，PHP进程无读取权限时就会触发「文件不存在」的报错。可执行命令ls -l /home/zuficcomap/test/wp-includes/sodium_compat/src/Compat.php查看权限配置，确认异常后批量修正wp-includes目录的权限及所有者即可。
• 对齐PHP与WordPress版本兼容关系：从报错日志可见当前PHP include_path指向PHP7.0的库目录，若你升级后的PHP版本不在当前WordPress版本的支持范围内，会导致sodium_compat依赖加载异常。确认当前WordPress版本要求的PHP版本区间，对齐版本后重新下载对应版本的WordPress官方安装包，单独替换wp-includes、wp-admin两个核心目录，避免本地文件损坏带来的异常。
• 确认PHP open_basedir配置：多数虚拟主机或服务器会配置open_basedir限制PHP可读取的目录范围，若站点根目录/home/zuficcomap/test/未被加入允许列表，也会触发文件读取失败的报错。可新建phpinfo文件查看当前open_basedir配置，确认站点目录在允许读取的范围内。

针对首页CSS样式混乱的问题 #

• 校验资源路径配置：打开首页源代码查看CSS文件的链接地址，确认是否还残留本地localhost/zufic的路径、或者路径拼接错误。同时核查wp_options表中siteurl、home两个字段的取值，确认均为http://test.zufic.com，无多余斜杠或拼写错误。
• 清理全链路缓存：依次清理浏览器本地缓存（强制刷新按Ctrl+F5）、站点残余缓存（哪怕已禁用缓存插件也建议删除wp-content/cache目录下的所有文件）、服务器/CDN层缓存，排除缓存残留加载旧资源的问题。
• 排查硬编码路径问题：因本地站点部署在/zufic子目录，远程站点部署在根目录，需检查主题目录、页面构建器配置中是否存在硬编码的/zufic/前缀路径，统一替换为远程站点的正确路径即可。

内容的提问来源于stack exchange，提问作者Arno Bob Jauffret