安装环境检测不通过，提示“数据库名、用户名或密码不正确”
报错现象：
在 WordPress 安装向导最后一步，明明输入了正确的数据库信息，却依然提示“无法连接到数据库”，或者直接卡在“创建配置文件”步骤不前进。
原因分析：
大多数时候不是密码错了，而是 wp-config.php 文件里的 DB_HOST 值有问题，很多虚拟主机（特别是宝塔面板、cPanel）的数据库主机不是 localhost，而是 0.0.1 或带端口号的地址（如 localhost:3307）,数据库用户权限没有绑定到对应库名也会触发此问题。
wp-config.php 里藏着的 7 个致命陷阱，从白屏到死循环，照着改就能救回来
解决步骤：
- 用 FTP 或文件管理器打开网站根目录下的
wp-config.php。 - 找到以下三行代码：
define('DB_NAME', '你的库名'); define('DB_USER', '你的用户名'); define('DB_PASSWORD', '你的密码'); define('DB_HOST', 'localhost'); - 将
DB_HOST的localhost改为0.0.1，保存后刷新安装页。 - 若仍然失败，去主机控制面板查看 MySQL 的“远程访问”或“主机”设置，有的面板会显示完整的连接地址（
sql123.example.com），直接复制填入。 - 如果数据库端口不是 3306，在
DB_HOST后加端口号，localhost:3307。 - 最后用 phpMyAdmin 验证该用户是否拥有该库的“全部权限”，没有则勾选“全选”并应用。
数据库连接错误（Error establishing a database connection）
报错现象：
网站前端直接显示 “Error establishing a database connection”,后台登录页也进不去。
原因分析：
最常见的原因是服务器负载过高导致 MySQL 进程挂掉，或者 wp-config.php 里定义了错误的 DB_CHARSET 和 DB_COLLATE 值，引起连接中断，某些安全插件会在配置文件中写入强制 SSL 或缓存设置,干扰正常连接。
解决步骤：
- 首先重启 MySQL 服务（命令行：
systemctl restart mysql或service mysqld restart），同时检查服务器内存是否充足（free -m）。 - 打开
wp-config.php，找到这两行：define('DB_CHARSET', 'utf8mb4'); define('DB_COLLATE', '');DB_COLLATE被改成了非空值（utf8mb4_unicode_ci之外的乱码），请清空为 。 - 在
wp-config.php中临时添加一行调试代码：define('WP_DEBUG', true);保存后刷新页面，看是否显示具体 SQL 错误，如果错误指向“too many connections”，说明数据库连接数耗尽，需要在主机商处调高
max_connections限制。 - 如果以上都无效，下载一份全新的
wp-config-sample.php，重新填写数据库信息替换原文件（注意备份原有内容）。
500 内部服务器错误
报错现象：
访问任何页面都返回“500 Internal Server Error”，控制台看不到任何 PHP 错误（因为 PHP 错误显示被关闭）。
原因分析：
wp-config.php 中存在语法错误（比如不小心删了分号、多写了括号），或者 WP_DEBUG 被设置为 false 导致错误被隐藏，服务器 PHP 版本过低，代码中使用了不兼容的函数也会触发 500。
解决步骤：
- 修改
wp-config.php中WP_DEBUG为：define('WP_DEBUG', true); define('WP_DEBUG_DISPLAY', true);（如果找不到这两行，手动添加在
ABSPATH定义之前） - 刷新页面，此时屏幕会直接显示 PHP 错误的具体行号和文件。
- 根据提示检查
wp-config.php对应行，常见错误为：- 字符串漏了引号：
define('DB_NAME'， 'mydb')中间用的是中文逗号。 - 结尾少了
?>或者多余的空格导致输出 BOM 头。
- 字符串漏了引号：
- 如果错误指向某行代码，直接复制那行粘贴到文本编辑器中，用“显示所有字符”功能检查是否有隐藏字符（如 UTF-8 BOM）。
- 修改完成后将
WP_DEBUG改回false。
白屏死机（页面一片空白，无任何输出）
报错现象：
浏览器加载后全白，既无文字也无错误码,查看源代码也是空白的。
原因分析：
通常是因为 wp-config.php 文件中使用了不兼容的 WP_MEMORY_LIMIT 值（比如设为 64M，而服务器实际只分配了 32M），或者 FS_METHOD 被设置为 direct 但目录权限不足。
解决步骤：
- 打开
wp-config.php，找到或添加：define('WP_MEMORY_LIMIT', '256M');如果已有该行但数值小于 128M，直接调大。
- 检查文件末尾是否有多余的空行或空格，正确的
wp-config.php最后一行应该是require_once ABSPATH . 'wp-settings.php';，并且该行之后不能有任何字符。 - 如果用了缓存插件，尝试添加以下代码禁用缓存：
define('WP_CACHE', false); - 用 SFTP 将
wp-config.php下载到本地，用 Notepad++ 打开，菜单栏“编码”→“转为 UTF-8 无 BOM 格式”,保存后重新上传覆盖。
插件冲突导致异常（激活某个插件后全站崩溃）
报错现象：
安装或更新某个插件后，网站立刻变成 500 或白屏,连后台都进不去。
原因分析：
插件可能在激活时通过 wp-config.php 文件写入自定义常量，或者修改了数据库表前缀，导致后续加载失败，有些插件还会强制修改 DB_COLLATE 值。
解决步骤：
- 用 FTP 进入
/wp-content/plugins/目录，将最近安装的插件文件夹重命名（bad-plugin改成bad-plugin-disabled），这样该插件会自动失效。 - 登录后台（如果还能登录），进入“插件”页面，确认失效后重启该插件，看是否复现问题。
- 如果用代码无法解决，检查
wp-config.php底部是否有插件留下的自动加载代码，require_once(ABSPATH . 'wp-content/plugins/xxx/load.php');直接删除这几行。
- 恢复后，在插件页面逐个激活其他插件,找到真正的冲突源。
自动更新失败并回滚（更新到一半卡死）
报错现象：
后台点“更新到 WordPress 最新版”后，页面停止不动，刷新后提示“更新失败：无法解压文件”或“回滚到旧版本”。
原因分析：
wp-config.php 中强制定义了 FS_METHOD 为 ssh2 或 ftpext，但服务器并没有开启相应扩展，或目录 wp-content 写入权限不足。
解决步骤：
- 在
wp-config.php中添加或修改：define('FS_METHOD', 'direct'); - 确保
wp-content目录及其子目录有 755 权限（文件 644），并让所有者与 PHP 执行用户一致（可用chown -R www:www /网站根目录）。 - 删除
wp-content/upgrade文件夹（如果有），重新创建并赋予 755 权限。 - 更新完毕后，注释掉
FS_METHOD行（前面加 ）,等下一次更新时再取消注释。
登录页面重定向循环（wp-login.php 无限刷新）
报错现象：
访问 /wp-login.php 时页面一直加载，或者提示“此网页造成了过多的重定向”。
原因分析：
最常见的是 wp-config.php 中写死了 WP_HOME 和 WP_SITEURL，但站点实际域名是 HTTP 还是 HTTPS 没统一（比如强制 HTTPS 但证书无效），另一个原因是 ADMIN_COOKIE_PATH 被错误设置。
解决步骤：
- 检查
wp-config.php中是否有以下两行：define('WP_HOME', 'http://example.com'); define('WP_SITEURL', 'http://example.com');如果这两个地址与实际访问地址（如带
www或https）不一致，就会重定向，将两者改成当前浏览器地址栏中的完整URL（确保协议一致）。 - 如果用了 Cloudflare 或 CDN，在配置文件中临时添加：
$_SERVER['HTTPS'] = 'on';放在
ABSPATH定义之前，解决反向代理导致的 SSL 判断错误。 - 删除浏览器缓存，并用隐私模式访问
/wp-admin，若成功登录，再进“设置”→“常规”更新站点地址，最后把wp-config.php中的WP_HOME注释掉。
最后提醒： 任何对 wp-config.php 的修改，请先通过 FTP 下载一份备份，用纯文本编辑器（如 Notepad++、Sublime）编辑，切勿用记事本，改完后清除浏览器缓存和服务器缓存（如 Redis、Memcached），再测试，如果完全乱了，备份数据库后直接删除 wp-config.php，然后重新运行安装向导,重填信息即可救回整个站点。
发表评论