WordPress 報錯不可怕,可怕的是不知道哪里出了問題。 下面我把平時最容易遇到的 WordPress 報錯整理成一份“傻瓜版”對照表,遇到哪個直接翻到哪條,照著做基本都能解決。
你看到的報錯:
Error establishing a database connection
或者中文提示:“無法建立數據庫連接”
意思是: WordPress 找不到數據庫了。
常見原因:
解決辦法:
wp-config.php 文件。define('DB_NAME', '你的數據庫名');
define('DB_USER', '數據庫用戶名');
define('DB_PASSWORD', '數據庫密碼');
define('DB_HOST', 'localhost');
# @ $ %,別亂改,最好直接從主機商那里復制數據庫密碼。你看到的報錯: 打開的頁面是純白色,什么內容都沒有。
意思是: 程序報錯了,但錯誤被隱藏了。
常見原因:
解決辦法:
wp-content/themes 文件夾,把你當前用的主題文件夾改個名,比如改成 主題文件夾名_old。
WordPress 看到主題沒了,會自動切到默認主題,這樣你就能進后臺了。wp-content/plugins 文件夾改名為 plugins_old,這樣就禁用了所有插件。wp-config.php 里加一行代碼:
define('WP_MEMORY_LIMIT', '256M');
加到 /* That's all, stop editing! */ 上面。
你看到的報錯:
Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes)
意思是: PHP 內存不夠用了。
解決辦法:
wp-config.php,在文件中加入:
define('WP_MEMORY_LIMIT', '256M');
如果不行就改成 512M。
PHP設置 或 php.ini 里修改:
memory_limit = 512M
你看到的報錯:
500 Internal Server Error
網站直接打不開,通常沒有詳細提示。
常見原因:
.htaccess 文件損壞解決辦法:
.htaccess 文件改名為 .htaccess_old,再看網站能不能打開。
如果好了,就是 .htaccess 的問題。重新登錄到后臺,到“設置 → 固定鏈接”里重新保存一下就好。你看到的報錯:
一直跳轉回登錄頁,根本進不了后臺,比如:wp-login.php 反復跳轉。
常見原因:
解決辦法:
wp-config.php,加入:
define('WP_HOME', 'http://你的域名');
define('WP_SITEURL', 'http://你的域名');
注意不要帶結尾斜杠。
你看到的報錯: 文章寫完了,點擊發布,結果鏈接打開是 404 Not Found。
常見原因:
.htaccess 權限不對解決辦法:
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
如果文件丟了,重新創建一下。
你看到的報錯:
The uploaded file exceeds the upload_max_filesize directive in php.ini
意思是: 服務器限制了上傳文件的大小。
解決辦法:
upload_max_filesize 改成 64M 或 128M。post_max_size 改成比上傳限制更大的值,比如 128M。memory_limit 改成 256M。如果用的是虛擬主機不能改 php.ini,可以試試在 .htaccess 里加:
php_value upload_max_filesize 64M
php_value post_max_size 128M
不行的話,只能找主機商處理。
你看到的報錯:
Unable to create directory wp-content/uploads/2024/06. Is its parent directory writable by the server?
意思是: 上傳目錄不存在,或者沒有寫入權限。
解決辦法:
wp-content 文件夾,看看有沒有 uploads 文件夾。uploads 文件夾。uploads 文件夾的權限設置為 755 或 775。777(注意臨時使用,成功后改回來)。wp-content 文件夾本身的權限是不是 755 或 775。你看到的報錯:
Briefly unavailable for scheduled maintenance. Check back in a minute.
意思是: WordPress 正在自動更新,但更新卡住了,或者沒刪干凈維護文件。
解決辦法:
.maintenance 文件。你看到的報錯:
Update failed: Could not create directory.
或者:
Unable to write to wp-content/plugins/
意思是: WordPress 沒有權限寫入插件或主題目錄。
解決辦法:
wp-content/plugins 和 wp-content/themes。755 或 775。www 或 nobody。777,更新完后改回 755。你看到的報錯:
Warning: Cannot modify header information - headers already sent by (output started at ...)
意思是: 在輸出內容之前,有文件輸出了空白字符、中文標點或空格。
常見原因:
wp-config.php 文件里,<;?php 前面有空格或空行?>; 并且后面跟著換行解決辦法:
wp-config.php。<;?php,前面不能有任何內容。?>;,建議直接刪掉 ?>;,一個文件最后一行不要留任何多余字符。你看到的報錯:
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。上面這些報錯,絕大多數都和主題、插件、權限、配置有關。 遇到問題不要慌,先做這三件事:
plugins 文件夾改個名,禁用所有插件。wp-config.php,開啟 WP_DEBUG 看具體錯誤。只要能定位到具體文件,問題就解決一半了。
希望這份“報錯對照表”能幫到你。