別慌,這些坑幾乎人人都踩過,看完你就能從“報錯懵圈”變成“淡定修車”。
第一次裝 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 網站馬上就能上線了!