WordPress 常见报错汇总,遇到直接对照解决

常见问题 关键词:Wordpress,Wordpress建设,WordPress外贸网站搭建服务,独立站搭建,网页设计

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 看具体错误。

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

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



[返回上一级]

相关推荐

WordPress 常见报错汇总,遇到直接对照解决
常见问题

WordPress 常见报错汇总,遇到直接对照解决

WordPress 报错不可怕,可怕的是不知道哪里出了问题。 下面我把平时最容易遇到的 WordPress 报错整理成一份“傻瓜版”对照表,遇到哪个直接翻到哪条,照着做基本都能解决。1. 建立数据库连接错误你看到的报错: Error est

WordPress 网站 SEO 做不好,多半是这几个原因
产品知识

WordPress 网站 SEO 做不好,多半是这几个原因

很多人建了 WordPress 网站,辛辛苦苦写内容,结果发现 Google 就是不待见,流量少得可怜。这时候别急着怪“玄学”,其实 SEO 做不好,多半是踩了下面这几个坑。1. 速度太慢,用户和搜索引擎都没耐心WordPress 本身不算

WordPress 怎么做 SEO?新手快速上手的实操指南
产品知识

WordPress 怎么做 SEO?新手快速上手的实操指南

很多人一听到 SEO 就头大,觉得是玄学。其实,用 WordPress 做 SEO 一点都不难,只要掌握几个核心点,新手也能快速上手。今天这篇文章不扯虚的,直接告诉你该装什么插件、该改哪里、日常要做什么,照着做就行。先搞懂:WordPres

想靠 Shopify 搞跨境,先看完这篇再交学费
产品知识

想靠 Shopify 搞跨境,先看完这篇再交学费

最近总有人问我:“现在做跨境电商是不是都靠 Shopify?听说自己建个网站就能卖到全世界,不用交平台入驻费,流量还都是自己的?” 然后转头就花了几千甚至几万去买“Shopify 建站实操课程”。我真替他们捏把汗。不是说 Shopify 不

2026 做 Shopify 独立站,还有机会吗?
产品知识

2026 做 Shopify 独立站,还有机会吗?

这个问题,这几年几乎每年都有人问。2020 年问:“现在做晚不晚?” 2022 年问:“红利期过了吧?” 2024 年问:“还能赚到钱吗?” 到了 2026 年,大家干脆问:“还有机会吗?”说实话,机会依然有,只是“捡钱”的时代彻底结束了。

属于合优的精彩“六.一”儿童节
公司资讯

属于合优的精彩“六.一”儿童节

对于一群已经进入社会,出来工作人,估计对“六.一”儿童节并没有什么期待,因为毕竟已经过了那个童真,天真,可爱的年龄了,但是合优很体贴员工,希望每个员工在这个节日都能感受到儿时过节的气氛,于是乎我们给员工们准备了大大的惊喜。 在儿童节来临之前

2018合优端午茶话会
公司资讯

2018合优端午茶话会

在古代很多文人雅士就创作很多歌颂端午节的诗词,而这首宋代词人欧阳修的《渔家傲》—“五月榴花妖艳烘,绿杨带雨垂垂重。五色新丝缠角粽,金盘送,生绡画扇盘双凤”,就描叙了端午节时候的天气和人们庆祝节日的习俗。秉承着传统文化的传承,合优于6月15日

激流勇进,合优技术精英游
公司资讯

激流勇进,合优技术精英游

平常生活和工作都在大都市里,看着繁华的街道,忙碌的过着日子,确实很少有机会去感受大自然的魅力,享受大自然的清新空气的同时,还可以煅练身体,于是我们决定到趁着这个周末假期我们来到了这个漂流之乡感受大自然的神奇力量。 因为受到台风的影响,早上时

科技素材库

© 2009-2022 版权所有    All right reserved联系我们 : 400 00 97929

深圳市导师团营销策划有限公司待完善

粤ICP备20067985号