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