在使用宝塔面板搭建 WordPress 站点后,访问域名或 IP 地址时没有出现 WordPress 的安装界面(如语言选择、数据库配置等),可能是由以下几个常见原因导致的。以下是详细的排查和解决方法:
✅ 一、检查是否已正确上传 WordPress 文件
-
确认网站根目录是否有 WordPress 文件
- 登录宝塔面板 → 网站 → 找到你的站点 → 点击「根目录」。
- 检查该目录下是否有
wp-config.php、wp-admin、wp-content、index.php等文件。 - 如果没有,请手动上传 WordPress 官方源码:
- 下载地址:https://wordpress.org/latest.zip
- 解压后将所有文件上传到网站根目录。
-
注意不要把文件放在子文件夹中
- 例如:不要放到
/www/wwwroot/your-site/wordpress/,而应直接放进去。
- 例如:不要放到
✅ 二、检查 wp-config.php 是否已存在且已配置
- 如果
wp-config.php已存在且配置了数据库信息,WordPress 会认为已经“安装过”,不会显示安装向导。 - 解决方法:
- 进入网站根目录,重命名或删除
wp-config.php(建议先备份)。 - 刷新网页,应该会跳转到安装页面(提示创建配置文件)。
- 进入网站根目录,重命名或删除
⚠️ 注意:删除前确保你知道数据库名、用户名、密码等信息,否则无法重新配置。
✅ 三、检查是否已经安装过 WordPress
- 如果你之前访问过安装页面并完成了安装流程,即使后来删了数据库,只要
wp-config.php存在或某些表残留,也可能无法再次进入安装页。 - 可尝试:
- 删除
wp-config.php - 清空数据库(或新建一个空数据库)
- 再次访问网站,触发安装流程。
- 删除
✅ 四、检查伪静态设置(Nginx/Apache)
- 虽然不影响安装页面显示,但如果伪静态错误,可能导致首页 404。
- 在宝塔面板中:
- 点击站点 → 设置 → 伪静态
- 选择「wordpress」
- 保存
✅ 五、检查 PHP 版本和扩展支持
WordPress 需要以下基本环境:
- PHP ≥ 7.4(推荐 8.0 或 8.1)
- 启用
mysqli、gd、curl、mbstring、xml等扩展
检查方法:
- 宝塔 → 软件商店 → 找到当前 PHP 版本 → 设置 → 安装扩展
- 确保
mysqli和pdo_mysql已启用
✅ 六、检查权限问题(Linux 系统)
确保网站目录有正确读写权限:
chown -R www:www /www/wwwroot/your-site
chmod -R 755 /www/wwwroot/your-site
特别是 wp-config.php 不可被公开读取,但需 PHP 可读。
✅ 七、清缓存 & 换浏览器测试
- 浏览器可能缓存了之前的响应(尤其是 301 跳转)。
- 尝试:
- 使用无痕模式
- 更换浏览器
- 清除 DNS 和页面缓存
✅ 八、查看错误日志定位问题
- PHP 错误日志:
- 宝塔 → 软件商店 → PHP → 日志 → error.log
- 网站访问日志:
- 宝塔 → 网站 → 日志 → 访问日志 / 错误日志
- 查看是否有
500,404,file not found等错误
✅ 九、强制触发安装页面
如果仍不显示安装页面,可以尝试访问:
http://你的域名/wp-admin/install.php
这会直接进入安装流程,绕过首页判断。
✅ 十、终极排查步骤总结
| 步骤 | 操作 |
|---|---|
| 1 | 删除或重命名 wp-config.php |
| 2 | 确保根目录有 WordPress 文件(如 index.php) |
| 3 | 检查数据库为空或新建一个 |
| 4 | 访问 http://域名/wp-admin/install.php |
| 5 | 查看 PHP 错误日志 |
示例:成功触发安装页面
- 删除
wp-config.php - 清空数据库
- 浏览器访问
http://yoursite.com - 应该看到:“您现在身处 WordPress 配置文件还未建立的境地…”
点击「现在就开始」即可进入安装流程。
如果你按照以上步骤操作后仍然无法显示安装界面,欢迎提供:
- 是否能看到首页但无内容?
- 是 404?500?空白页?
- PHP 版本?
- 错误日志截图?
我可以进一步帮你诊断。
云小栈