结论:宝塔面板一键部署 WordPress 后出现 Nginx 404 错误,通常是由于伪静态规则未配置、网站目录错误或 Nginx 配置不当所致。
-
检查伪静态规则是否正确配置
- 宝塔面板默认不会自动为 WordPress 添加伪静态规则,尤其在使用 Nginx 环境下。
- 登录宝塔后台,进入对应网站的“设置”页面,在“伪静态”选项卡中选择“WordPress”,然后保存。
- 如果没有该规则,可以手动添加如下伪静态规则:
location / { try_files $uri $uri/ /index.php?$args; } -
确认网站根目录设置无误
- WordPress 的入口文件
index.php和.htaccess文件应位于网站根目录。 - 检查宝塔中站点配置的“网站目录”是否指向了正确的路径,例如
/www/wwwroot/yourdomain.com。 - 若你将 WordPress 安装在子目录中,请确保访问地址与目录结构一致。
- WordPress 的入口文件
-
检查Nginx配置文件是否有冲突或错误
- 进入宝塔后台的“网站”页面,点击对应站点右侧的“配置”按钮,查看 Nginx 配置内容。
- 确保没有重复的
location /或其他重写规则干扰了 WordPress 的正常运行。 - 如有自定义配置,建议备份后尝试恢复默认配置并重新应用伪静态规则。
-
重启Nginx服务以应用更改
- 修改完配置后,务必点击“保存”并重启 Nginx 服务,使新的配置生效。
- 可通过宝塔左侧菜单中的“软件商店”找到 Nginx,点击“重启”。
-
检查权限和文件是否存在
- 使用宝塔文件管理器或 SSH 登录服务器,确认
/index.php文件存在。 - 确认 WordPress 的安装包是否完整,必要时可重新上传核心文件。
- 使用宝塔文件管理器或 SSH 登录服务器,确认
-
启用调试模式辅助排查
- 编辑 WordPress 根目录下的
wp-config.php文件,查找并设置:define('WP_DEBUG', true); - 这有助于发现潜在的 PHP 错误或路径问题。
- 编辑 WordPress 根目录下的
总结:
解决宝塔一键部署 WordPress 出现 Nginx 404 的关键在于配置伪静态规则和确认网站目录正确。 此外,检查 Nginx 配置、文件完整性及权限也是常见排查步骤。遇到复杂情况时,建议逐步排除每一个可能因素,从而快速定位问题根源。
CDNK博客