常見問題
先做這一件事
出任何問題，先看網站根目錄的 runtime.log。
注意是根目錄那個 runtime.log，不是 runtime/log/ 裡的。絕大多數問題的真實原因都寫在裡面。
DEBUG=false時，任何未捕獲的異常都會被渲染成 404 頁面並返回 HTTP 500 —— 頁面上什麼線索都沒有，真實原因只在runtime.log裡。
安裝與訪問
只有首頁能開啟，點任何連結都是 404 偽靜態沒配。見 偽靜態規則。
白屏 / 500 多半缺 bcmath 擴充套件。所有金額計算都靠它，缺了直接致命錯誤。裝法見 安裝總覽。
安裝嚮導提示目錄不可寫config、runtime、kernel/Install、assets/cache 四個目錄要可寫。寶塔使用者把網站目錄所有者設為 www。
Docker 容器起來了但瀏覽器打不開 連接埠對映寫反了。-p 8080:80 左邊是宿主機連接埠，右邊固定是 80。雲伺服器還要在安全組裡放行連接埠。
Docker 升級後資料沒了 當初沒加 -v acg_data:/data。見 Docker 安裝。
搬家之後
網站搬家後不能用，按順序查：
config/database.php裡的資料庫連線資訊是不是還是舊的- 舊站如果用過 Redis 存會話，新伺服器也要裝，或者把 PHP 的 session 儲存改回檔案
- PHP 擴充套件裝齊沒有（尤其
bcmath） - 目錄權限、偽靜態要重新配
詳見 升級與遷移。
訂單與支付
買家付了錢沒收到貨
- 後臺 商品訂單 裡按訂單號或聯絡方式搜，確認單子在
- 看狀態：還是「未支付」說明支付回撥沒回來
- 回撥回不來的常見原因：支付平臺配的回撥地址不對、CDN 防火牆把回撥攔了
- CDN 導致的用自定義支付回撥域名解決，見 網站設定
庫存明明有，前臺顯示無貨 商品配了種類或 SKU 時，庫存是按規格分別統計的。某個規格沒卡密，那個規格就買不了。也可能是卡密被鎖定了。見 卡密管理。
買家選了年卡，發出來是月卡 匯入卡密時沒選對種類。
商品顯示 0 元 會員價留空時，登入使用者可能按 0 元買走。定價時把會員價一起填上。見 支付設定。
分站
子域名打不開 三件事缺一不可：後臺配了主站域名和 DNS-CNAME、域名服務商加了 * 泛解析、伺服器上繫結了 *.你的域名。最後一條最容易漏。
獨立域名打不開 伺服器沒設預設站點。見 分站模組。
店鋪共享
新增店鋪失敗 地址、商戶 ID 或金鑰不對，或者對方站點沒開共享。
客戶下單報錯、發不出貨 你在上游的餘額不夠。共享下單是拿你在上游的餘額進貨的。
商品列表拉不到 對方的商品沒開「API 對接」開關。
外掛與主題
外掛裝了沒反應 裝完要到 通用外掛 裡啟用。
外掛加了新的 Hook 檔案不生效 鉤子登錄檔是編譯快取，需要把外掛停用再啟用一次才會重建。
換主題後顯示不正常 清模板快取：刪除 runtime/view/compile 目錄下的內容。
不要刪
runtime/config，那是配置快取，刪了整站會出問題。
提問的正確姿勢
沒有人能透過三言兩語判斷你遇到了什麼問題。提問前先準備好：
runtime.log的內容 —— 出問題後網站根目錄會有，下載下來開啟- 前因後果 —— 你做了什麼操作之後才出現的
- 截圖 —— 只要和問題相關的都帶上
準備齊了再問，才是最省時間的做法。三言兩語描述問題當然也可以，總會有熱心網友幫你，但那絕不會讓你更快 —— 只會來回問上半天。
去哪問
- Telegram：https://t.me/mcyofficial