萬盛學電腦網

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

Discuz! 報錯「請檢查 DNT.config 中 DbType 節點」完整排查指南

錯誤現象

System.Exception: 請檢查 DNT.config 中 DbType 節點資料庫類型是否正確,例如:SqlServer、Access、MySql
   於 Discuz.Data.DatabaseProvider.GetProvider()
   於 Discuz.Data.DatabaseProvider..cctor()
TypeInitializationException: "Discuz.Data.DatabaseProvider" 的類型初始化項引發異常

核心原因

Discuz! 無法根據 DNT.config 中的 DbType 值,正確載入對應的數據訪問提供程序程式集(Discuz.Data.SqlServer.dll、Discuz.Data.Access.dll 或 Discuz.Data.MySql.dll)。常見三大原因:

  1. DNT.config 中 DbType 值拼寫錯誤或大小寫不匹配。
  2. 對應的數據提供程序 DLL 缺失於 /bin 目錄。
  3. IIS 應用程式池權限不足,無法讀取配置文件或載入 DLL。

標準排查流程(按成功率排序)

1. 驗證 DNT.config 配置(最常見)

打開網站根目錄下的 DNT.config,找到 <DbType> 節點,確保值完全匹配以下三者之一(區分大小寫):

<DbType>SqlServer</DbType>      <!-- SQL Server 2000/2005/2008/2012/2016/2019 -->
<DbType>Access</DbType>        <!-- Access (.mdb) -->
<DbType>MySql</DbType>         <!-- MySQL (官方 Connector/Net) -->

❌ 常見錯誤:sqlserver、MYSQL、Sql Server、MySQL5 等。

2. 確認 Bin 目錄核心 DLL 存在

根據 DbType 值,/bin 目錄必須存在對應 DLL:

DbType 值必需 DLL 文件備註
SqlServerDiscuz.Data.SqlServer.dll最常用,隨主程式發布
AccessDiscuz.Data.Access.dll較少見
MySqlDiscuz.Data.MySql.dll需額外引用 MySql.Data.dll

💡 快速檢查命令(Linux/Mac/Git Bash):

ls -la bin/Discuz.Data.*.dll

3. 修正 IIS 權限(Windows Server 典型問題)

  1. 確認應用程式池身份:建議使用 ApplicationPoolIdentity 或專用網域帳號,勿用 NetworkService/LocalSystem。
  2. 賦予網站物理目錄權限:IIS_IUSRS、應用程式池身份帳號 → 讀取、寫入、修改(特別是 /bin、/config、/data、/uc_client/data/cache)。
  3. 啟用 32 位應用程式(若使用 32 位 Oracle/MySQL 驅動):應用程式池 → 進階設置 → 啟用 32 位應用程式 = True。

4. 檢查數據庫連接字串

同一 DNT.config 中的 <ConnectionString> 必須與 DbType 匹配:

<!-- SqlServer 範例 -->
<ConnectionString>Server=127.0.0.1;Database=DiscuzDB;User ID=sa;Password=yourpass;Pooling=true;</ConnectionString>

<!-- MySql 範例 -->
<ConnectionString>Server=127.0.0.1;Database=DiscuzDB;Uid=root;Pwd=yourpass;Charset=utf8;Pooling=true;</ConnectionString>

5. 清理緩存與重啟

# 1. 刪除模板緩存
rm -rf data/cache/*  # Linux
del /s /q data\cache\*  # Windows CMD

# 2. 重啟 IIS 應用程式池 / 站點
iisreset /restart

進階排查:啟用詳細錯誤日誌

修改 web.config 獲取完整堆疊:

<system.web>
  <customErrors mode="Off" />
  <compilation debug="true" />
</system.web>

查看 Event Viewer → Windows Logs → Application 或 /log/ 目錄下的錯誤日誌,定位具體 FileNotFoundException 或 ConfigurationErrorsException。

MySQL 專用額外檢查

  • 確認 MySql.Data.dll (Connector/Net) 版本與 Discuz.Data.MySql.dll 兼容(建議 6.9.x / 8.0.x)。
  • web.config 中註冊 MySQL 提供程序:
<system.data>
  <DbProviderFactories>
    <remove invariant="MySql.Data.MySqlClient"/>
    <add name="MySQL Data Provider" invariant="MySql.Data.MySqlClient" 
         description=".Net Framework Data Provider for MySQL" 
         type="MySql.Data.MySqlClient.MySqlClientFactory, MySql.Data, Version=8.0.33.0, Culture=neutral, PublicKeyToken=c5687fc88969c44d"/>
  </DbProviderFactories>
</system.data>

總結檢查清單

  1. [ ] DNT.config → DbType = SqlServer | Access | MySql(大小寫精確)
  2. [ ] /bin/Discuz.Data.{DbType}.dll 存在
  3. [ ] /bin/MySql.Data.dll 存在(僅 MySQL)
  4. [ ] ConnectionString 格式與 DbType 匹配
  5. [ ] IIS 應用程式池身份有目錄讀寫權限
  6. [ ] 清理緩存、重啟應用程式池

✅ 逐項核對,99% 情況可解決。若仍失敗,請提供完整異常堆疊與 DNT.config 內容(脫敏密碼)尋求協助。

copyright © 萬盛學電腦網 all rights reserved