部署相關(guān)問題 ?
安裝頁面打不開 ?
現(xiàn)象：訪問域名后顯示空白或報錯。
排查步驟：
- 確認(rèn)站點根目錄指向
public/文件夾 - 確認(rèn) PHP 版本為 8.0+
- 檢查
runtime/目錄是否有寫權(quán)限
安裝時數(shù)據(jù)庫連接失敗 ?
現(xiàn)象：填寫數(shù)據(jù)庫信息后提示連接失敗。
排查步驟：
- 確認(rèn) MySQL 服務(wù)已啟動
- 檢查數(shù)據(jù)庫地址、端口、用戶名、密碼是否正確
- 確認(rèn) MySQL 用戶有創(chuàng)建數(shù)據(jù)庫的權(quán)限
- 如果是遠(yuǎn)程數(shù)據(jù)庫，確認(rèn)防火墻已放行 3306 端口
頁面顯示 404 ?
現(xiàn)象：首頁正常，但點擊其他頁面顯示 404。
原因：偽靜態(tài)（URL 重寫）未配置。
解決：
- Nginx：參考 Nginx 部署 添加偽靜態(tài)配置
- Apache：確認(rèn)
mod_rewrite已啟用，public/.htaccess文件存在 - 寶塔：參考 寶塔面板 配置偽靜態(tài)
登錄后提示"未授權(quán)" ?
現(xiàn)象：輸入正確的賬號密碼后，進(jìn)入系統(tǒng)提示"未授權(quán)"或自動跳回登錄頁。
原因：JWT Token 的 Authorization 頭未傳遞到 PHP。
解決：
- Nginx：在 PHP 配置中添加
fastcgi_param HTTP_AUTHORIZATION $http_authorization; - Apache：通常無需額外配置，檢查
.htaccess是否被覆蓋
靜態(tài)資源加載失敗 ?
現(xiàn)象：頁面樣式錯亂，JS/CSS 文件 404。
排查步驟：
- 確認(rèn)
public/assets/目錄存在且有文件 - 如果為空，需要重新構(gòu)建前端：
cd web && npm run build - 檢查瀏覽器控制臺的具體報錯路徑
更多幫助 ?
- 環(huán)境要求 → 確認(rèn)服務(wù)器配置
- Nginx 部署 → Nginx 配置參考
- Apache 部署 → Apache 配置參考
- 寶塔面板 → 寶塔部署參考
- 使用問題 FAQ → 功能使用相關(guān)問題