宝塔面板搭建WordPress出现404错误的解决方法

来自:素雅营销研究院

头像 方知笔记
2025年07月29日 02:24

问题描述

在使用宝塔面板(BT Panel)搭建WordPress网站时,部分用户可能会遇到访问页面时出现404 Not Found错误的情况。这种问题通常出现在安装完成后,访问网站首页或后台时页面无法正常加载,严重影响网站的正常使用。

可能的原因

  1. 伪静态规则未正确配置:WordPress依赖伪静态规则(如Nginx的rewrite规则)来实现友好的URL结构,若未正确配置,可能导致404错误。
  2. 网站根目录设置错误:如果WordPress文件未正确放置在网站根目录,或者宝塔面板的网站路径配置有误,也会导致404问题。
  3. PHP版本不兼容:某些PHP版本可能与WordPress核心文件或插件不兼容,导致路由解析失败。
  4. 权限问题:网站目录或文件的读写权限不足,导致服务器无法正常访问WordPress的核心文件。
  5. 缓存或CDN影响:如果启用了缓存插件或CDN服务,旧缓存可能导致新页面无法加载。

解决方法

1. 检查并配置伪静态规则

  • Nginx环境: 在宝塔面板中找到对应网站的设置伪静态,选择WordPress规则(或手动添加以下代码):
location / {
try_files $uri $uri/ /index.php?$args;
}
  • Apache环境: 确保.htaccess文件存在并包含正确的WordPress规则(通常安装时会自动生成)。

2. 确认网站根目录

  • 进入宝塔面板的网站对应站点设置网站目录,检查路径是否指向WordPress的安装目录(如/www/wwwroot/yourdomain.com)。
  • 确保index.php文件存在于根目录中。

3. 调整PHP版本

  • 在宝塔面板的网站PHP版本中,切换至WordPress推荐的PHP版本(如7.4或8.0),避免兼容性问题。

4. 修复文件权限

  • 通过宝塔面板的文件管理,将WordPress目录权限设置为755,文件权限设置为644
  • 确保wp-content目录可写(权限可设为755775)。

5. 清除缓存

  • 如果使用了缓存插件(如WP Super Cache、W3 Total Cache),尝试清除缓存。
  • 若启用了CDN(如Cloudflare),暂停CDN或刷新缓存后再测试。

6. 检查固定链接设置

  • 登录WordPress后台(如yourdomain.com/wp-admin),进入设置固定链接,重新保存一次当前设置(无需修改),以刷新伪静态规则。

总结

404错误通常与服务器配置或文件路径有关,通过排查伪静态、目录权限、PHP版本等问题,大多数情况下可以快速解决。如果问题仍未解决,建议检查宝塔面板的网站日志/www/wwwlogs)或WordPress的debug.log,进一步定位错误原因。