萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

ThinkPHP 關閉調試模式 (APP_DEBUG=false) 報錯三大案例與解決方案

案例一:Runtime 目錄權限不足

現象:本地開發正常,部署到伺服器首次訪問正常,重新整理出現「頁面調試錯誤,無法找開頁面,請重試」。

原因:APP_DEBUG=false 時,框架會將編譯快取寫入 Runtime/Cache/、Runtime/Logs/,目錄需可寫權限。

解決:

chmod -R 777 Runtime/
# 或更安全:
chown -R www-data:www-data Runtime/
chmod -R 755 Runtime/

案例二:短標籤 (short_open_tag) 未開啟導致編譯快取解析失敗

現象:關閉調試模式後報錯:

Parse error: syntax error, unexpected T_STRING in .../Runtime/~app.php on line 1

原因:調試模式開啟時,框架每次重新編譯並自動補上 ;關閉後載入已編譯的 ~app.php,若該檔使用短標籤 而 PHP 未開啟 short_open_tag,導致解析失敗。

解決:修改 php.ini:

short_open_tag = On

或統一程式碼使用完整標籤 (推薦)。

案例三:關閉調試模式後資料庫查詢總是回傳第一筆資料

現象:APP_DEBUG=false 時 select()/find() 只回傳第一條;開啟則正常。

原因:快取機制導致 SQL 參數綁定異常,或快取未正確更新。

排查步驟:

  1. 關閉調試模式,手動刪除 Runtime/Cache/ 所有檔案再測試。
  2. 在模型/查詢處加入臨時日誌:Log::write($model->getLastSql(), 'sql') 查看實際 SQL。
  3. 檢查 DB_FIELDS_CACHE 是否導致欄位快取不一致。

根治:確保部署流程包含 php think clear (ThinkPHP 5/6) 或手動清理 Runtime 快取。

部署檢查清單

  • [ ] APP_DEBUG=false (生產環境)
  • [ ] Runtime/ 目錄 Web 使用者可讀寫
  • [ ] short_open_tag=On 或程式碼無短標籤
  • [ ] 部署腳本執行快取清理指令
  • [ ] 錯誤日誌寫入權限正常 (Runtime/Logs/)
copyright © 萬盛學電腦網 all rights reserved