WordPress 报错不可怕，可怕的是不知道哪里出了问题。 下面我把平时最容易遇到的 WordPress 报错整理成一份“傻瓜版”对照表，遇到哪个直接翻到哪条，照着做基本都能解决。

---

1. 建立数据库连接错误

你看到的报错： Error establishing a database connection 或者中文提示：“无法建立数据库连接”

意思是： WordPress 找不到数据库了。

常见原因：

• 数据库名、用户名、密码写错了
• 数据库服务器挂了
• 数据库表损坏
• 服务器太忙，连接超时

解决办法：

1. 打开 WordPress 根目录下的 wp-config.php 文件。
2. 检查下面几行：

   define('DB_NAME', '你的数据库名');
   define('DB_USER', '数据库用户名');
   define('DB_PASSWORD', '数据库密码');
   define('DB_HOST', 'localhost');

3. 如果密码里有特殊字符，比如 # @ $ %，别乱改，最好直接从主机商那里复制数据库密码。
4. 确认无误后，重新访问网站。
5. 如果还是不行，去宝塔、cPanel 或 phpMyAdmin 里确认数据库服务是否正常启动。
6. 如果数据库没问题，但网站怎么也连不上，试试在 phpMyAdmin 里选择数据库，点击“检查表”或“修复表”。

---

2. 后台进不去，一片空白（白屏）

你看到的报错： 打开的页面是纯白色，什么内容都没有。

意思是： 程序报错了，但错误被隐藏了。

常见原因：

• 主题或插件冲突
• PHP 内存不够
• 主题文件里出现致命错误

解决办法：

1. 用 FTP 或宝塔进入 wp-content/themes 文件夹，把你当前用的主题文件夹改个名，比如改成 主题文件夹名_old。 WordPress 看到主题没了，会自动切到默认主题，这样你就能进后台了。
2. 如果还不行，把 wp-content/plugins 文件夹改名为 plugins_old，这样就禁用了所有插件。
3. 能进后台后，再一个个启用主题和插件，找到“元凶”。
4. 如果是 PHP 内存不够，在 wp-config.php 里加一行代码：

   define('WP_MEMORY_LIMIT', '256M');

   加到 /* That's all, stop editing! */ 上面。

---

3. 内存超出限制

你看到的报错： Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes)

意思是： PHP 内存不够用了。

解决办法：

1. 用 FTP 打开 wp-config.php，在文件中加入：

   define('WP_MEMORY_LIMIT', '256M');

   如果不行就改成 512M。

2. 如果加了还是不够，需要去宝塔面板里的 PHP设置 或 php.ini 里修改：

   memory_limit = 512M

3. 改完后重启一下 PHP 服务。

---

4. 500 内部服务器错误

你看到的报错： 500 Internal Server Error 网站直接打不开，通常没有详细提示。

常见原因：

• .htaccess 文件损坏
• 插件或主题冲突
• PHP 内存不足
• 服务器配置问题

解决办法：

1. 先尝试通过 FTP 把根目录的 .htaccess 文件改名为 .htaccess_old，再看网站能不能打开。 如果好了，就是 .htaccess 的问题。重新登录到后台，到“设置 → 固定链接”里重新保存一下就好。
2. 如果还是 500，禁用所有插件，换个默认主题，一步步排查。
3. 到主机面板或宝塔里看错误日志，里面会写明是哪个文件出错。
4. 检查 PHP 版本是否过低，建议使用 PHP 7.4 及以上。

---

5. 后台无限重定向

你看到的报错： 一直跳转回登录页，根本进不了后台，比如：wp-login.php 反复跳转。

常见原因：

• 站点地址设置不对
• 网站链接和后台链接不一致
• Cookie 或缓存冲突
• 用了 Cloudflare 等你代理服务导致循环

解决办法：

1. 打开 wp-config.php，加入：

   define('WP_HOME', 'http://你的域名');
   define('WP_SITEURL', 'http://你的域名');

   注意不要带结尾斜杠。

2. 把域名替换成你自己真实的网址。
3. 保存后清理一下浏览器 Cookie，再访问后台。
4. 如果你用了 Cloudflare，先暂停“Always Use HTTPS”或“SSL”相关设置，看看还会不会循环。

---

6. 文章发布后 404 找不到页面

你看到的报错： 文章写完了，点击发布，结果链接打开是 404 Not Found。

常见原因：

• 固定链接设置没刷新
• 服务器不支持伪静态
• .htaccess 权限不对

解决办法：

1. 进入后台：“设置 → 固定链接”，随便选一个别的格式，再换回来，最后点击“保存设置”。
2. 这个操作会刷新固定链接缓存。
3. 如果还是 404，检查服务器是否开启了 mod_rewrite。
4. 检查 .htaccess 文件是否存在，并且内容类似：

   # BEGIN WordPress
   <;IfModule mod_rewrite.c>;
   RewriteEngine On
   RewriteBase /
   RewriteRule ^index\.php$ - [L]
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteCond %{REQUEST_FILENAME} !-d
   RewriteRule . /index.php [L]
   <;/IfModule>;
   # END WordPress

   如果文件丢了，重新创建一下。

---

7. 上传文件大小超限

你看到的报错： The uploaded file exceeds the upload_max_filesize directive in php.ini

意思是： 服务器限制了上传文件的大小。

解决办法：

1. 去宝塔或主机控制面板，找到 PHP 设置。
2. 把 upload_max_filesize 改成 64M 或 128M。
3. 把 post_max_size 改成比上传限制更大的值，比如 128M。
4. 把 memory_limit 改成 256M。
5. 保存后重启 PHP。

如果用的是虚拟主机不能改 php.ini，可以试试在 .htaccess 里加：

php_value upload_max_filesize 64M
php_value post_max_size 128M

不行的话，只能找主机商处理。

---

8. 提示“无法创建目录”

你看到的报错： Unable to create directory wp-content/uploads/2024/06. Is its parent directory writable by the server?

意思是： 上传目录不存在，或者没有写入权限。

解决办法：

1. 用 FTP 进入 wp-content 文件夹，看看有没有 uploads 文件夹。
2. 如果没有，手动创建 uploads 文件夹。
3. 将 uploads 文件夹的权限设置为 755 或 775。
4. 如果还不行，改成 777（注意临时使用，成功后改回来）。
5. 同时要检查 wp-content 文件夹本身的权限是不是 755 或 775。

---

9. 提示“正在执行例行维护，请稍后再来”

你看到的报错： Briefly unavailable for scheduled maintenance. Check back in a minute.

意思是： WordPress 正在自动更新，但更新卡住了，或者没删干净维护文件。

解决办法：

1. 用 FTP 进入网站根目录。
2. 找到 .maintenance 文件。
3. 把这个文件删掉。
4. 刷新网站就能立即恢复访问。

---

10. 更新失败，提示“无法写入”

你看到的报错： Update failed: Could not create directory. 或者： Unable to write to wp-content/plugins/

意思是： WordPress 没有权限写入插件或主题目录。

解决办法：

1. 用 FTP 进入 wp-content/plugins 和 wp-content/themes。
2. 将这些文件夹权限设置为 755 或 775。
3. 如果还是不行，检查文件夹所属用户，通常是 www 或 nobody。
4. 你可以把权限暂时改成 777，更新完后改回 755。

---

11. 出现“Headers already sent” 报错

你看到的报错： Warning: Cannot modify header information - headers already sent by (output started at ...)

意思是： 在输出内容之前，有文件输出了空白字符、中文标点或空格。

常见原因：

• wp-config.php 文件里，<;?php 前面有空格或空行
• 文件末尾有 ?>; 并且后面跟着换行
• 主题文件里不小心多了一个空格

解决办法：

1. 用高级编辑器（如 Notepad++、VS Code）打开 wp-config.php。
2. 检查第一个字符是不是 <;?php，前面不能有任何内容。
3. 检查文件末尾是不是有 ?>;，建议直接删掉 ?>;，一个文件最后一行不要留任何多余字符。
4. 保存时使用 UTF-8 无 BOM 格式。

---

12. 提示“网站遇到技术问题”

你看到的报错： The site is experiencing technical difficulties. 这是新版 WordPress 的致命错误提示。

意思是： 网站出现了致命错误，但为了安全，只给了用户一个模糊提示。

解决办法：

1. 打开 wp-config.php，把 define('WP_DEBUG', false); 改成：

   define('WP_DEBUG', true);
   define('WP_DEBUG_LOG', true);

2. 保存后再次打开网站，就会看到具体错误信息。
3. 根据错误信息找到对应主题或插件，禁用或删除。
4. 也可以去 wp-content/debug.log 看详细日志。
5. 排查完记得把 WP_DEBUG 改回 false。

---

最后再提醒一句

上面这些报错，绝大多数都和主题、插件、权限、配置有关。 遇到问题不要慌，先做这三件事：

1. 用 FTP 把 plugins 文件夹改个名，禁用所有插件。
2. 把当前主题文件夹改个名，切回默认主题。
3. 打开 wp-config.php，开启 WP_DEBUG 看具体错误。

只要能定位到具体文件，问题就解决一半了。

希望这份“报错对照表”能帮到你。

[返回上一级]