WordPress 装到一半报错，真的是新手建站最容易破防的一刻。前面环境装了，站点建了，数据库也填了，结果一点击安装，不是数据库连接错误，就是访问域名还停在宝塔默认页，再不然直接甩你一个 403、404、502。最磨人的不是“完全没开始”，而是你明明觉得就差一步，偏偏这一步能卡你半晚上。
赚客出海见过太多这种现场。很多人一遇到“安装失败”四个字，第一反应就是删站点、删数据库、重装面板，动作一个比一个猛。可问题是，故障还没定位，你先把现场清空了。这样不是排错，是重开。电脑一死机就先拔电源，动静很大，问题不一定真在那。
先把结论拍前面：宝塔装 WordPress 失败，先别急着重装，先分清是数据库问题、文件目录问题、权限问题，还是伪静态、PHP 和站点配置问题。 多数报错都不是大故障，而是小地方填错、放错、漏配了。对。就这么现实。
本文目录
先说结论：先判断你属于哪一种失败
你现在最该做的，不是再点一次“安装”，也不是到处翻零碎教程，而是先判断现象。现象判断对了，后面排查才不会乱。
| 当前现象 | 多半卡点 | 先查哪里 |
|---|---|---|
| 提示数据库连接错误 | 数据库名、用户名、密码、主机填写错误 | 数据库页 / phpMyAdmin / 安装页信息 |
| 访问域名还是宝塔默认页 | 文件目录放错、站点根目录不对 | 文件管理 / 站点根目录 |
| 首页能开，文章页 404 | 固定链接或伪静态没配 | WordPress 固定链接 / 宝塔站点设置 |
| 403 Forbidden | 权限或所属用户异常 | 站点权限 / 一键修复权限 |
| 502 Bad Gateway / 空白页 | PHP 服务异常、版本不兼容、资源不足 | PHP 服务 / 错误日志 / 服务器资源 |
先把自己归进表里，再往下查。别一上来就推倒重来。重装不是排错，那叫重开。
第一类：数据库连接错误，先查这 4 个地方
1、数据库到底有没有创建成功
这个最基础，也最容易被忽略。很多新手以为点过“创建数据库”就算结束，实际库根本没建成功，或者建了一半异常退出。先回到宝塔左侧「数据库」，看数据库是否真的存在，名字是不是和安装页里填的一样。
你现在缺的，真的是“再试一次安装”吗？不是。先确认数据库这件事到底有没有真的发生。
2、数据库名、用户名、密码有没有抄错
这一步听着很蠢，但真是高频翻车点。尤其是密码带符号、大小写、复制时多一个空格，新手特别容易在这里翻。别嫌麻烦，重新从宝塔数据库页核对一遍。数据库名、用户名、密码，三个字段逐个对。
3、数据库主机别乱改，先用 localhost
很多人看到“数据库主机”就开始发挥，以为要填 IP，或者填宝塔面板地址。别折腾。单机环境先老老实实填 localhost。你如果不是在做数据库分离部署，这里擅自改，出错概率很高。
4、先打开一次 phpMyAdmin，看数据库服务是不是活着
这是个很实用的小动作。进宝塔数据库页，点一下 phpMyAdmin。如果能正常打开，说明数据库服务大概率是活的。要是这里都打不开，那问题就不止是 WordPress 安装页填错，而是数据库服务本身就没跑稳。
如果你连基础安装流程都还没顺一遍，先把主教程补上，再回来排错会轻松很多：宝塔面板安装 WordPress 教程。
第二类：访问域名还是默认页，多半是目录放错了
这个坑，每年都有新手稳定踩中。WordPress 压缩包解压后，通常会多出一个 wordpress 文件夹。很多人看到文件出来了，就以为安装完一半了，实际真正该做的是：把这个文件夹里面的文件，移动到站点根目录。
注意，是里面的文件移出来，不是把整个 wordpress 文件夹原封不动放着。少这一步，你访问域名时就可能还是宝塔默认页，或者根本不跳安装页。你现在最该怀疑的是安装包坏了吗？多数时候不是，是目录根本没放对。
换成操作就是：
- 去「文件」里打开站点根目录；
- 看根目录下是不是又套了一层 wordpress 文件夹；
- 如果有，打开它；
- 把里面所有文件移动到站点根目录；
- 删掉空文件夹，再刷新访问。
小动作。大影响。很多所谓“安装失败”，就是这个目录问题。
第三类：403、404 这类错误，先查权限和伪静态
1、403 Forbidden 先修权限
403 这种报错，新手一看到就容易发懵。其实多数时候不用上升到系统级大故障。先去宝塔站点设置里找权限修复，看看有没有“一键修复权限”之类的入口。先修一遍，再刷新页面。
这类问题，很多时候不是 WordPress 本身坏了，而是文件权限、所属用户没对齐。你现在最该做的不是重装，而是先把权限归位。
2、文章页 404，不一定是网站没装好
首页能打开，后台能进去，偏偏文章页 404，这很像“站坏了”，其实常常只是固定链接和伪静态没配好。WordPress 后台里先把固定链接改成“文章名”，再回到宝塔对应站点，把伪静态规则切到 WordPress。
这两个动作是配套的。只做一个，不够。你这时候还在怀疑数据库吗？大概率已经查错方向了。
第四类：502、空白页、安装一半卡住，先看 PHP 和资源
502 这种问题，味道就不一样了。它通常不是简单的“填错了”，而是 PHP 服务、兼容性、资源占用这几块出了状况。先别慌，排查顺序很简单：
- 先看 PHP 服务是不是正常运行；
- 再看当前 PHP 版本是不是太老，或者和主题/插件环境冲突；
- 再看服务器配置是不是太小，尤其是小配置机子；
- 最后再看错误日志，别全靠猜。
真是 WordPress 三个字有问题吗？很多时候不是，是 PHP 在喊累，或者服务根本没正常工作。别把问题全怪到安装包头上。
翻车误区清单：别把时间浪费在这些假动作上
误区一：一报错就重装面板
动静很大，收益未必高。数据库密码填错、目录套一层、伪静态没配，这些问题你重装十次面板也不会自动消失。
误区二：只看报错表面，不看现象分类
“安装失败”这四个字太大了。数据库错、权限错、目录错、PHP 错，全都叫安装失败。你不先分类，后面就只能瞎修。
误区三：后台能进，就以为前台问题和安装无关
不对。很多前台异常，本质上就是安装后的收尾没补齐。这个位子后面有单独子文，你遇到了直接跳过去更快：宝塔装 WordPress 后前台异常。
误区四：没看到一键入口，就怀疑整套流程都错了
入口只是入口，不是本质。如果你连软件商店里都找不到 WordPress，先把那个入口误区修掉：宝塔找不到 WordPress 怎么办。
可复制动作清单：安装失败后，照这个顺序救
- 先分现象：数据库错、默认页、403/404、502，先归类；
- 再核数据库：看数据库是否存在，账号密码是否准确；
- 再查目录：确认 WordPress 文件是不是放在站点根目录；
- 再修权限：遇到 403，优先修权限；
- 再配伪静态：首页正常、内页 404，优先看这里；
- 再看 PHP：502、空白页、安装卡住，先查服务和版本；
- 最后看日志：不要一直靠猜。
就按这个顺序。先大类，后细项。先能定位，再谈修复。顺序一对，排错效率会高很多。
这 3 种情况，直接看对应文章更省时间
- 如果你现在是后台能进，但前台白屏、没样式、404，直接看：宝塔装 WordPress 后前台异常
- 如果你现在连 WordPress 入口都没找到，直接看：宝塔找不到 WordPress 怎么办
- 如果你纠结的是 Windows 环境到底能不能继续装，直接看：Windows 能用宝塔装 WordPress 吗
怎么验证你已经修对了？
- 安装页能正常打开；
- 数据库信息提交后能继续下一步；
- 安装完成后，后台和前台都能正常访问；
- 切换固定链接后，内页不再 404。
做到这几条，才算真修好。下次再遇到安装失败，先别急着全删重来。先判断是哪一层坏了：数据库、目录、权限、伪静态、PHP。 你把这五层记住，后面大部分报错都不至于把你拖进死循环。
FAQ：新手最常追问的几个问题
1、宝塔装 WordPress 失败，要不要直接删库重来？
不建议一上来就删。先核对数据库信息和服务状态。很多时候只是填错，不是库本身坏了。
2、安装页不出来，是不是 WordPress 包有问题？
多数时候不是。更常见的是目录放错、站点根目录不对、域名解析没生效，或者还是宝塔默认页。
3、后台能进，但首页样式乱，这还算安装失败吗？
严格说更像安装后的前台异常。重点查 HTTPS、站点地址、缓存、主题和混合内容。
4、什么时候才值得考虑重装面板？
只有在网站、数据库、文件管理这些核心功能都异常，而且你已经排除浏览器、缓存、权限、服务问题后，才考虑重装。别拿重装当第一反应。
别急着重来，先把故障归类
宝塔装 WordPress 失败，真正容易把人搞崩的，不是报错本身，而是你看着一堆异常，不知道先从哪下手。可一旦你把问题拆成数据库、目录、权限、伪静态、PHP 这几层，事情就没那么吓人了。
先分现象，再查对应模块。 这句话你记住，后面会省很多冤枉时间。现在别继续乱点了，先回到宝塔后台，做两个最小动作：核对数据库信息，再检查站点根目录里有没有多套一层 wordpress 文件夹。 很多人的问题，就卡在这两步。
发表评论