萬盛學電腦網

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

Discuz! X3.0 正式版安裝插件白屏/無法啟用的臨時修復方案

問題現象

  • 後台應用中心安裝插件點擊「安裝」後直接白屏,無任何報錯
  • 已安裝插件點擊「啟用」同樣白屏
  • RC 版正常,正式版出現

根因分析

正式版新增 FORMHASH 驗證機制防 CSRF,但安裝/啟用流程中的跳轉鏈接未攜帶 formhash 參數,導致驗證失敗,腳本靜默終止(白屏)。

修復方案:移除安裝/啟用流程的 FORMHASH 強制驗證

文件 1:source/admincp/admincp_plugins.php

修復安裝白屏

搜索(約第 150 行):

} elseif(FORMHASH == $_GET['formhash'] && $operation == 'import') {

修改為:

} elseif($operation == 'import') {

修復啟用白屏(如有)

搜索並刪除以下片段(可能出現多次):

FORMHASH == $_GET['formhash'] &&

即將含該片段的完整 if/elseif 條件簡化為僅判斷 $operation。

操作步驟

  1. 備份 source/admincp/admincp_plugins.php
  2. 使用編輯器執行上述兩處修改
  3. 上傳覆蓋原文件
  4. 後台 → 工具 → 更新緩存
  5. 重新安裝/啟用插件驗證

安全性說明

風險提示: 移除 FORMHASH 驗證理論上降低 CSRF 防護等級。但插件安裝/啟用屬高權限管理員操作,且需知曉後台路徑,實際風險可控。官方後續版本已修復跳轉鏈接攜帶 formhash 問題,升級後請還原代碼。

驗證清單

  • ✅ 應用中心安裝新插件不再白屏
  • ✅ 已安裝插件啟用/禁用/卸載正常
  • ✅ 插件設置頁面正常訪問
  • ✅ 後台其他功能(非插件模塊)FORMHASH 驗證仍生效

總結

通過精準移除插件安裝/啟用流程中殘缺的 FORMHASH 驗證,快速恢復 Discuz! X3.0 正式版插件管理功能。屬臨時熱修復,建議納入部署腳本,待官方穩定版發布後同步升級。

copyright © 萬盛學電腦網 all rights reserved