主頁/文件/WordPress/WordPress 核心安裝步驟/1. 手動安裝 WordPress/內容詳情

解決 WordPress 安裝失敗嘅常見問題（權限錯誤、數據庫連接失敗等）

大約一分鐘
江蘇
2025-10-15
2025-10-21
12,305
當你透過以下連結購物,我會獲得佣金,對你嚟講冇額外成本。.

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 後台，開始打造自己嘅網站啦。

標籤: