主页/文件/WordPress/WordPress 核心安装步骤/1. 手动安装 WordPress/内容详情

解決WordPress安裝失敗的常見問題（許可權錯誤、資料庫連線失敗等）

约1分钟
江苏省
2025-10-15
2025-10-21
12,304
通过下方链接进行购物时，您无需支付额外费用，我就能获得佣金。.

WordPress 安裝過程通常很順利，但新手可能會遇到一些錯誤提示。這些問題看似複雜複雜，只要找到原因就能輕鬆解決。本節彙總了安裝失敗的常見問題及具體解決方法，幫你快速排查並完成安裝。

一、資料庫連線失敗（最常見錯誤）

錯誤表現

安裝時提示：「建立資料庫連線時出錯」或「Error establishing a database connection」，無法進入下一步。

可能原因及解決方法

  1. 資料庫資訊填寫錯誤（90% 的情況）
    • 檢查點：資料庫名、使用者名稱、密碼是否與記錄一致（區分大小寫）。
    • 解決步驟：
      1. 登入寶塔面板，進入「資料庫」頁面，確認資料庫名和使用者名稱。
      2. 若密碼錯誤，點選「更多」→「修改密碼」，生成新密碼並記錄。
      3. 返回安裝頁面，重新填寫正確資訊並提交。
  2. 資料庫主機地址錯誤
    • 檢查點：「資料庫主機」是否填寫正確（新手幾乎都是localhost）。
    • 解決步驟：
      1. 預設填寫localhost，無需修改。
      2. 若伺服器商特殊說明（如某些海外主機），填寫提供的地址（如mysql.example.com）。
  3. 資料庫服務未啟動
    • 檢查點：伺服器上的 MySQL 服務是否正常執行。
    • 解決步驟：
      1. 登入寶塔面板，點選左側「軟體商店」。
      2. 找到已安裝的 MySQL，檢視狀態是否為「執行中」。
      3. 若未執行，點選「重啟」按鈕啟動服務。
  4. 資料庫使用者無許可權
    • 檢查點：資料庫使用者是否有訪問該資料庫的許可權。
    • 解決步驟：
      1. 登入寶塔面板，進入「資料庫」→ 點選資料庫後的「管理」，進入 phpMyAdmin。
      2. 點選頂部選單「使用者賬戶」，找到對應的資料庫使用者。
      3. 確認該使用者對目標資料庫有「所有許可權」，若無則重新授權。

二、許可權錯誤（無法建立檔案 / 寫入配置）

錯誤表現

提示：「無法寫入 wp-config.php 檔案」或「無法建立目錄」，安裝中斷。

可能原因及解決方法

  1. 網站目錄許可權不足
    • 檢查點：伺服器上的網站根目錄許可權設定是否正確。
    • 解決步驟：
      1. 登入寶塔面板，進入「網站」→ 找到對應網站，點選「更多」→「許可權」。
      2. 將「目錄許可權」設定為 755，「檔案許可權」設定為 644。
      3. 所有者選擇 www（或伺服器預設的執行使用者），點選「應用」。
  2. 手動建立 wp-config.php 檔案
    • 若提示無法寫入配置檔案，可手動建立：
      1. 在安裝錯誤頁面，點選「建立配置檔案」，複製頁面中的程式碼。
      2. 登入寶塔面板，進入網站根目錄，點選「新建檔案」，命名為 wp-config.php。
      3. 雙擊檔案開啟編輯器，貼上複製的程式碼，點選「儲存」。
      4. 返回安裝頁面，點選「進行安裝」繼續。
  3. 檔案所有權錯誤
    • 檢查點：檔案是否屬於伺服器執行使用者（如 Apache 或 Nginx 的執行使用者）。
    • 解決步驟：
      1. 在寶塔檔案管理中，選中網站根目錄，點選「許可權」。
      2. 將「所有者」和「所屬組」改為伺服器執行使用者（通常是 www 或者 nginx）。
      3. 勾選「應用到子目錄」，點選「確定」。

三、安裝過程中斷或白屏

錯誤表現

安裝到一半突然卡住、頁面空白（白屏），或顯示「500 內部伺服器錯誤」。

可能原因及解決方法

  1. PHP 版本不相容
    • 檢查點：伺服器 PHP 版本是否符合 WordPress 要求（推薦 7.4 及以上）。
    • 解決步驟：
      1. 登入寶塔面板，進入「網站」→ 找到對應網站，點選「PHP 版本」。
      2. 選擇 PHP 7.4 或 8.0（相容性最佳），點選「切換」。
      3. 切換後重新訪問安裝頁面。
  2. PHP 記憶體限制不足
    • 檢查點：PHP 記憶體限制過低，導致安裝過程中斷。
    • 解決步驟：
      1. 登入寶塔面板，進入「軟體商店」→ 找到已安裝的 PHP，點選「設定」。
      2. 進入「配置檔案」，搜尋 memory_limit，將值修改為 128M 或者 256M。
      3. 點選「儲存」，重啟 PHP 服務。
  3. 安裝檔案損壞或不完整
    • 檢查點：上傳的 WordPress 安裝包是否損壞。
    • 解決步驟：
      1. 從官方重新下載 WordPress 安裝包（參考 7.1 節）。
      2. 登入寶塔面板，刪除網站根目錄中的所有檔案。
      3. 重新上傳並解壓新的安裝包（參考 7.2 節），重新開始安裝。

四、其他常見錯誤及解決

  1. 域名未解析或伺服器埠未開放
    • 錯誤表現：訪問域名時無法開啟安裝頁面，顯示「無法訪問此網站」。
    • 解決步驟：
      1. 檢查域名是否已解析到伺服器 IP（參考 4.4 節）。
      2. 登入伺服器控制檯，確認 80 埠（HTTP）和 443 埠（HTTPS）已開放。
      3. 若透過 IP 訪問，確認寶塔面板未限制 IP 訪問。
  2. 資料庫表字首衝突
    • 錯誤表現：提示「表已存在」或安裝後資料混亂。
    • 解決步驟：
      1. 若之前安裝過 WordPress，登入 phpMyAdmin 刪除舊資料庫表。
      2. 或在安裝時修改表字首（如將 wp_ 改为 wp2023_）。
  3. 防火牆或安全外掛攔截
    • 錯誤表現：安裝頁面載入緩慢或被攔截。
    • 解決步驟：
      1. 暫時關閉伺服器防火牆或安全組規則（安裝完成後再開啟）。
      2. 若使用國內伺服器，檢查是否因備案問題被攔截（未備案域名無法使用 80/443 埠）。

排查錯誤的通用技巧

  1. 檢視錯誤日誌
    • 登入寶塔面板，進入「網站」→ 對應網站的「日誌」，檢視「錯誤日誌」，裡面會記錄具體錯誤原因。
  2. 簡化安裝環境
    • 若使用了複雜的伺服器配置，暫時恢復預設設定（如 PHP 擴充套件、偽靜態規則等）。
  3. 尋求幫助
    • 複製錯誤提示文字，在搜尋引擎中搜索解決方案（通常能找到同類問題的解決方法）。
    • 聯絡伺服器商客服，提供錯誤截圖，讓技術人員協助排查。

总结一下

安裝失敗大多是由於資訊填寫錯誤、許可權設定不當或環境不相容導致的，按照本節方法逐一排查，99% 的問題都能解決。如果多次嘗試仍失敗，建議重新梳理流程：從資料庫建立、檔案上傳到資訊填寫，每一步都仔細核對，確保操作正確。

解決問題後，你就可以順利進入 WordPress 後臺，開始打造自己的網站了。

标签：