WordPress 报错不可怕,可怕的是不知道哪里出了问题。
下面我把平时最容易遇到的 WordPress 报错整理成一份“傻瓜版”对照表,遇到哪个直接翻到哪条,照着做基本都能解决。
1. 建立数据库连接错误
你看到的报错:
Error establishing a database connection
或者中文提示:“无法建立数据库连接”
意思是:
WordPress 找不到数据库了。
常见原因:
- 数据库名、用户名、密码写错了
- 数据库服务器挂了
- 数据库表损坏
- 服务器太忙,连接超时
解决办法:
- 打开 WordPress 根目录下的 wp-config.php 文件。
- 检查下面几行: define('DB_NAME', '你的数据库名'); define('DB_USER', '数据库用户名'); define('DB_PASSWORD', '数据库密码'); define('DB_HOST', 'localhost');
- 如果密码里有特殊字符,比如 # @ $ %,别乱改,最好直接从主机商那里复制数据库密码。
- 确认无误后,重新访问网站。
- 如果还是不行,去宝塔、cPanel 或 phpMyAdmin 里确认数据库服务是否正常启动。
- 如果数据库没问题,但网站怎么也连不上,试试在 phpMyAdmin 里选择数据库,点击“检查表”或“修复表”。
2. 后台进不去,一片空白(白屏)
你看到的报错:
打开的页面是纯白色,什么内容都没有。
意思是:
程序报错了,但错误被隐藏了。
常见原因:
- 主题或插件冲突
- PHP 内存不够
- 主题文件里出现致命错误
解决办法:
- 用 FTP 或宝塔进入 wp-content/themes 文件夹,把你当前用的主题文件夹改个名,比如改成 主题文件夹名_old。
WordPress 看到主题没了,会自动切到默认主题,这样你就能进后台了。
- 如果还不行,把 wp-content/plugins 文件夹改名为 plugins_old,这样就禁用了所有插件。
- 能进后台后,再一个个启用主题和插件,找到“元凶”。
- 如果是 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 内存不够用了。
解决办法:
- 用 FTP 打开 wp-config.php,在文件中加入: define('WP_MEMORY_LIMIT', '256M');
如果不行就改成 512M。
- 如果加了还是不够,需要去宝塔面板里的 PHP设置 或 php.ini 里修改: memory_limit = 512M
- 改完后重启一下 PHP 服务。
4. 500 内部服务器错误
你看到的报错:
500 Internal Server Error
网站直接打不开,通常没有详细提示。
常见原因:
- .htaccess 文件损坏
- 插件或主题冲突
- PHP 内存不足
- 服务器配置问题
解决办法:
- 先尝试通过 FTP 把根目录的 .htaccess 文件改名为 .htaccess_old,再看网站能不能打开。
如果好了,就是 .htaccess 的问题。重新登录到后台,到“设置 → 固定链接”里重新保存一下就好。
- 如果还是 500,禁用所有插件,换个默认主题,一步步排查。
- 到主机面板或宝塔里看错误日志,里面会写明是哪个文件出错。
- 检查 PHP 版本是否过低,建议使用 PHP 7.4 及以上。
5. 后台无限重定向
你看到的报错:
一直跳转回登录页,根本进不了后台,比如:wp-login.php 反复跳转。
常见原因:
- 站点地址设置不对
- 网站链接和后台链接不一致
- Cookie 或缓存冲突
- 用了 Cloudflare 等你代理服务导致循环
解决办法:
- 打开 wp-config.php,加入: define('WP_HOME', 'http://你的域名'); define('WP_SITEURL', 'http://你的域名');
注意不要带结尾斜杠。
- 把域名替换成你自己真实的网址。
- 保存后清理一下浏览器 Cookie,再访问后台。
- 如果你用了 Cloudflare,先暂停“Always Use HTTPS”或“SSL”相关设置,看看还会不会循环。
6. 文章发布后 404 找不到页面
你看到的报错:
文章写完了,点击发布,结果链接打开是 404 Not Found。
常见原因:
- 固定链接设置没刷新
- 服务器不支持伪静态
- .htaccess 权限不对
解决办法:
- 进入后台:“设置 → 固定链接”,随便选一个别的格式,再换回来,最后点击“保存设置”。
- 这个操作会刷新固定链接缓存。
- 如果还是 404,检查服务器是否开启了 mod_rewrite。
- 检查 .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
意思是:
服务器限制了上传文件的大小。
解决办法:
- 去宝塔或主机控制面板,找到 PHP 设置。
- 把 upload_max_filesize 改成 64M 或 128M。
- 把 post_max_size 改成比上传限制更大的值,比如 128M。
- 把 memory_limit 改成 256M。
- 保存后重启 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?
意思是:
上传目录不存在,或者没有写入权限。
解决办法:
- 用 FTP 进入 wp-content 文件夹,看看有没有 uploads 文件夹。
- 如果没有,手动创建 uploads 文件夹。
- 将 uploads 文件夹的权限设置为 755 或 775。
- 如果还不行,改成 777(注意临时使用,成功后改回来)。
- 同时要检查 wp-content 文件夹本身的权限是不是 755 或 775。
9. 提示“正在执行例行维护,请稍后再来”
你看到的报错:
Briefly unavailable for scheduled maintenance. Check back in a minute.
意思是:
WordPress 正在自动更新,但更新卡住了,或者没删干净维护文件。
解决办法:
- 用 FTP 进入网站根目录。
- 找到 .maintenance 文件。
- 把这个文件删掉。
- 刷新网站就能立即恢复访问。
10. 更新失败,提示“无法写入”
你看到的报错:
Update failed: Could not create directory.
或者:
Unable to write to wp-content/plugins/
意思是:
WordPress 没有权限写入插件或主题目录。
解决办法:
- 用 FTP 进入 wp-content/plugins 和 wp-content/themes。
- 将这些文件夹权限设置为 755 或 775。
- 如果还是不行,检查文件夹所属用户,通常是 www 或 nobody。
- 你可以把权限暂时改成 777,更新完后改回 755。
11. 出现“Headers already sent” 报错
你看到的报错:
Warning: Cannot modify header information - headers already sent by (output started at ...)
意思是:
在输出内容之前,有文件输出了空白字符、中文标点或空格。
常见原因:
- wp-config.php 文件里,<;?php 前面有空格或空行
- 文件末尾有 ?>; 并且后面跟着换行
- 主题文件里不小心多了一个空格
解决办法:
- 用高级编辑器(如 Notepad++、VS Code)打开 wp-config.php。
- 检查第一个字符是不是 <;?php,前面不能有任何内容。
- 检查文件末尾是不是有 ?>;,建议直接删掉 ?>;,一个文件最后一行不要留任何多余字符。
- 保存时使用 UTF-8 无 BOM 格式。
12. 提示“网站遇到技术问题”
你看到的报错:
The site is experiencing technical difficulties.
这是新版 WordPress 的致命错误提示。
意思是:
网站出现了致命错误,但为了安全,只给了用户一个模糊提示。
解决办法:
- 打开 wp-config.php,把 define('WP_DEBUG', false); 改成: define('WP_DEBUG', true); define('WP_DEBUG_LOG', true);
- 保存后再次打开网站,就会看到具体错误信息。
- 根据错误信息找到对应主题或插件,禁用或删除。
- 也可以去 wp-content/debug.log 看详细日志。
- 排查完记得把 WP_DEBUG 改回 false。
最后再提醒一句
上面这些报错,绝大多数都和主题、插件、权限、配置有关。
遇到问题不要慌,先做这三件事:
- 用 FTP 把 plugins 文件夹改个名,禁用所有插件。
- 把当前主题文件夹改个名,切回默认主题。
- 打开 wp-config.php,开启 WP_DEBUG 看具体错误。
只要能定位到具体文件,问题就解决一半了。
希望这份“报错对照表”能帮到你。
[返回上一级]