易優CMS安裝常見問題總結

EyouCMS作爲一款基於PHP+MySQL開發的企業建站系統，在實際安裝部署過程中，由於服務器環境差異、操作流程不當等原因，常常會遇到各種各樣的問題。本文彙總了7個最常見的安裝報錯及其解決方法，供大家參考。

問題一：安裝報錯“請仔細覈對數據庫賬號和密碼”

報錯現象：

安裝過程中提示“數據庫連接失敗，請重新設定”或“請仔細覈對數據庫賬號和密碼”。

原因分析：

此問題通常是由於填寫的數據庫連接信息不正確導致的。包括數據庫地址、數據庫名稱、用戶名、密碼等任何一項填寫錯誤，都會導致CMS無法連接到數據庫。

解決方法：

1. 檢查數據庫地址：本地環境通常爲localhost或127.0.0.1，遠程數據庫需填寫正確的IP地址或域名。

2. 檢查數據庫端口：默認端口爲3306，如使用非默認端口需正確填寫。

3. 檢查數據庫用戶名和密碼：確保賬號密碼正確無誤，不確定時可嘗試重置密碼。

4. 檢查數據庫名稱：確認數據庫已經創建且名稱填寫正確。

5. 檢查數據庫用戶權限：確保數據庫用戶具有創建表、插入數據等必要權限。

6. 如以上步驟均無誤，可嘗試通過phpMyAdmin等工具驗證數據庫連接信息是否有效。

問題二：本地測試正常，放到虛擬主機出現include_once報錯

報錯現象：

PHP Warning: include_once(./templates/step1.php): failed to open stream: No such file or directory 
PHP Warning: include_once(): Failed opening './templates/step1.php' for inclusion

虛擬主機PHP 5.5，數據庫MySQL 5.6環境下出現此警告。

原因分析：

虛擬主機環境不兼容，PHP版本與EyouCMS的安裝要求不匹配。

解決方法：

1. 登錄虛擬主機控制面板，找到PHP版本設置。

2. 將PHP版本調整至5.4（優先推薦），或在5.4-7.3之間嘗試兼容版本。

3. 調整後刷新安裝頁面，若仍報錯可嘗試清除瀏覽器緩存後重試。

核心思路：這類問題基本都是環境問題，通過切換PHP版本一般都能解決。

問題三：打包備份後上傳安裝，第四步報錯寫入表ey_ad_position失敗

報錯現象：

{"msg":"u5199u5165u8868ey_ad_positionu8bb0u5f55u5931u8d25uff0cu8bf7u5c1du8bd5F5u5237u65b0!"}

即“寫入表ey_ad_position記錄失敗，請嘗試F5刷新！”。

原因分析：

數據庫缺失關鍵更新語句，導致表ey_ad_position無法正常寫入數據。

解決方法：

1. 新建文本文檔，複製以下兩條SQL語句，保存爲eyou.sql文件：

   UPDATE `ey_ad_position` SET `height` = 0 WHERE `height` is NULL OR `height` = ''; 
   UPDATE `ey_ad_position` SET `width` = 0 WHERE `width` is NULL OR `width` = '';

    

2. 登錄原網站後臺，進入“備份還原”功能，上傳eyou.sql文件並執行。

3. 執行成功後，在後臺重新備份數據庫，打包成安裝包，再重新上傳至空間進行安裝。

更詳細的處理方案可參考官方問答：點擊跳轉

問題四：數據庫文件版本號與CMS源碼版本號不一致

報錯現象：

“無法安裝，數據庫文件版本號(v1.3.5)與CMS源碼版本號(v1.3.6)不一致，點擊查看！”

原因分析：

此問題通常是因爲後臺升級後，沒有備份數據庫就直接打包搬家，導致數據庫版本與源碼版本不匹配。

解決方法（兩種）：

方法一（推薦，原網站仍存在時使用）：

回原網站備份數據庫後再打包搬家。搬家教程可參考：https://www.eyoucms.com/ask/list_1_1/4014.html

方法二（應急方案）：

修改CMS源碼版本號。打開data/conf/version.txt文件，將版本號改爲提示的數據庫版本號，然後繼續正常安裝。安裝完成後再將版本號改回原來的版本號。

提示：登錄網站後臺後記得及時備份數據庫！

問題五：安裝時提示寫入表ey_archives記錄失敗

報錯現象：

“安裝時數據庫提示寫入表ey_archives記錄失敗，請刷新重試”。

原因分析：

可能由多種原因導致，包括數據庫連接問題、權限問題、數據衝突、防火牆攔截或空間已滿等。

解決方法：

1. 清空數據庫，重新嘗試安裝。

2. 若清空後仍報錯，切換其他版本的數據庫（如將MySQL 8.0切換至5.6或5.7）。

3. 若因空間環境問題無法解決，可直接導入數據庫方法安裝，然後修改網站配置文件即可。

4. 特殊情況可檢查防火牆是否攔截、空間是否已滿。

問題六：安裝一直顯示未知錯誤，無法繼續

報錯現象：

安裝過程中始終顯示“未知錯誤”，無法繼續進行。

原因分析：

數據庫版本過高導致，EyouCMS對高版本MySQL（如MySQL 8.x）的兼容性可能存在問題。

解決方法：

1. 將MySQL數據庫版本設置爲5.6。

2. 可通過寶塔面板等管理工具來切換數據庫版本。

3. 同時可檢查服務器錯誤日誌、確認文件權限、檢查PHP擴展是否完整等。

問題七：安裝報錯Parse error語法錯誤

報錯現象：

Parse error: syntax error, unexpected '[' in /install/index.php on line 544

或類似語法錯誤提示。

原因分析：

PHP版本過高，與EyouCMS源碼的語法不兼容，導致PHP解析失敗。

解決方法：

1. 登錄空間控制面板，將PHP版本調整至5.5。

2. 調整後刷新安裝頁面重試。

3. 若仍報錯，可重新下載完整的CMS安裝包，替換install目錄後重試。

總結

以上7個問題是易優CMS安裝過程中最爲常見的報錯。歸納起來，絕大多數問題都源於以下三類原因：

建議在安裝前先確認服務器環境是否符合EyouCMS的官方要求，做好數據庫備份，可有效避免上述大部分問題的發生。