别慌,这些坑几乎人人都踩过,看完你就能从“报错懵圈”变成“淡定修车”。
第一次装 WordPress,就像第一次组装宜家家具——你以为按图纸来就行,结果螺丝多出来几个、板子装反了、还差点把手指头划破。WordPress 的“图纸”其实很简单,但因为服务器环境五花八门,总有几个“螺丝”对不上,于是报错就来了。
别慌,下面这些报错是新手最常遇到的,每一行我都用大白话讲清楚“咋回事”和“怎么办”。你照着做,90% 的问题都能解决。
咋回事? 就像你拿着钥匙开家门,但钥匙不对、门锁坏了、或者门牌号记错了。WordPress 找不到数据库,或者数据库不认你这个用户。
最常见原因:
wp-config.php 文件里改)。localhost,但有些主机要用 127.0.0.1 或别的主机名)。怎么解决?
打开 WordPress 根目录下的 wp-config.php 文件,找到这几行:
define('DB_NAME', '数据库名');
define('DB_USER', '用户名');
define('DB_PASSWORD', '密码');
define('DB_HOST', 'localhost');
按你的主机后台实际信息,逐个核对。注意:数据库名不是你的网址,也不是你的 FTP 用户名,别想当然。如果你压根还没建数据库,就去主机控制面板(比如 cPanel、宝塔)里新建一个 MySQL 数据库,并把用户绑定进去。
如果还是不行?
把 DB_HOST 从 localhost 改成 127.0.0.1 试试。再不行,就找你的主机商客服问“数据库连接地址是什么”,每个主机商可能不一样。
咋回事? 打开网站,什么内容都没有,一片纯白,或者显示“500 内部服务器错误”。这就像你打开电视,屏幕亮着但没节目——不是没电,是接收信号出了问题。
最常见原因:
.htaccess 文件有问题(特别是用了某些安全设置后)。怎么解决?
第一步: 去服务器后台的文件管理器(或 FTP),把 wp-content/themes/ 下的主题文件夹改个名,比如把 twentytwentyfour 改成 twentytwentyfour_bak。这样 WordPress 找不到原主题,会自动回退到默认主题。如果恢复正常了,那就是主题的问题。
第二步: 同理,把 wp-content/plugins/ 里的插件文件夹一个个改名,直到网站恢复,那就是那个插件的锅。改完名后台登录,把坏的插件删掉重装。
第三步: 如果还是白屏,查看网站根目录下有没有 .htaccess 文件(可能是隐藏文件)。把它的名字改成 .htaccess_bak,然后去后台“设置 → 固定链接”里保存一下,它会重新生成一个新的 .htaccess。
第四步: 检查 PHP 版本。在主机面板里把 PHP 版本切换到 7.4 或 8.0 比较稳妥(具体看你主题/插件要求)。如果切完就好了,说明原来版本太旧或太新。
咋回事?
哎,这个和报错一名字很像,但一般出现在“WordPress 地址”或“站点地址”设置错的时候。比如你把网址写成了 http:// 但实际是 https://,或者填了带 www 的,但你的域名不带 www。
怎么解决?
去数据库里改一下 URL。用 phpMyAdmin(主机面板里一般都有)打开你的数据库,找到 wp_options 表,把 siteurl 和 home 这两个选项的值改成正确的网址。比如从 http://example.com 改成 https://example.com。
如果你不知道数据库怎么进,也可以用最简单的方法:在 wp-config.php 文件里加两行:
define('WP_HOME', 'http://你的网址');
define('WP_SITEURL', 'http://你的网址');
把你的网址替换进去,保存后再刷新网页。注意 http 还是 https 要看清楚。
咋回事? WordPress 就像一个大吃货,一次性点的菜太多,结果你的服务器只准备了小餐桌,放不下,它就喊“我撑不住了”。
怎么解决?
在 wp-config.php 文件里,找到 /* 好了!请不要再继续编辑。请保存本文件。 */ 这一行,在上面添加:
define('WP_MEMORY_LIMIT', '256M');
保存刷新。还不够?把 256M 改成 512M(大部分主机都支持)。如果改了没用,那就是主机商把 PHP 内存限制了,你可以在 .htaccess 文件里加:
php_value memory_limit 256M
如果还是不行,那就去问主机商,你的 PHP memory_limit 能不能调高一点。
咋回事? 你想传一个大图片或者视频,但 WordPress 默认只允许你传 2MB、4MB 或 8MB。就像你往行李箱里塞一个大西瓜,拉链拉不上。
怎么解决?
在 .htaccess 文件里加:
php_value upload_max_filesize 64M
php_value post_max_size 128M
php_value max_execution_time 300
保存刷新。如果没用,去主机面板找“PHP 设置”,手动把 upload_max_filesize 改大。宝塔面板里就在“软件商店 → PHP → 设置 → 配置修改”里找。
咋回事? 你的网站首页能打开,但点进文章或页面就“404 找不到”,就像你进了一栋楼,但每个房间门牌号都错了,导航找不到路。
最常见原因: Apache 服务器的伪静态规则没生效。WordPress 默认的“固定链接”不是 ?p=123 那种,而是 /archives/123 这种漂亮地址,但需要服务器开启 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
如果你用的是 Nginx 服务器(比如很多云服务器默认就是 Nginx),那 .htaccess 没用,得在 Nginx 配置里加:
location / {
try_files $uri $uri/ /index.php?$args;
}
改完别忘重启 Nginx 或 Apache。如果你用的是宝塔,直接在“网站设置 → 伪静态”里选择 WordPress 并保存即可。
咋回事? 你点了一个“现在更新”,结果报错说“无法安装更新”。可能原因很多,但最常见的就是文件权限不够,或者主机禁用了 SSH/FTP。
怎么解决?
简单粗暴:去主机后台把 WordPress 根目录下的所有文件和文件夹权限设置为 755(文件夹)和 644(文件),一般就 OK 了。
如果提示需要 FTP 账号,那就在 wp-config.php 里加:
define('FS_METHOD', 'direct');
保存后重新更新。如果还不行,那多半是你用了个烂主机,建议换一个口碑好点的。
咋回事? 你输入用户名密码,点登录,结果又跳回登录页,就像你按了门铃,门开了又关上,再按又开了又关上……主要是 cookie 或 session 设置不对,或者网址设置错误。
怎么解决?
先试试在浏览器里清除 cookie。如果还不行,检查 wp-config.php 里的 WP_HOME 和 WP_SITEURL 是否和你当前访问的网址完全一致(包括 http/https 和 www)。
另外,在 wp-config.php 里加:
define('COOKIE_DOMAIN', '');
保存后再试。如果还是不行,那就禁用所有插件(改插件文件夹名),再试登录,看是不是插件闹的。
咋回事?
这多半是角色权限或者数据库的表出了问题。常见于你在后台装了一些管理权限插件,或者 wp_options 表里的 active_plugins 数据出错。
怎么解决?
进 phpMyAdmin,找到 wp_options 表,搜索 active_plugins,把它的 option_value 改成:
a:0:{}
保存后,所有插件都会被禁用。然后再后台重新启用需要的插件。这样能解决大多数权限相关的“无权访问”问题。
如果你试了上面所有办法还是不行,别上头,按这个顺序做:
plugins 文件夹名为 plugins_off)wp-config.php 默认设置(重新下载官方版,把里面的数据库信息填上).htaccess 文件,后台重新保存固定链接深呼吸,把你遇到的报错截图,用搜索引擎搜一下原文,十有八九你已经能自己解决了。实在不行,去官方支持论坛或主机商工单求助,记得把你做过哪些操作写清楚。
装 WordPress 的过程,其实就是和服务器“交朋友”的过程。报错不是你的错,是它在教你服务器套路。今天你踩过的坑,以后都会变成你帮别人排错的资本。
加油,你的第一个 WordPress 网站马上就能上线了!