萬盛學電腦網

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

ASP.NET「/ 應用程式中的伺服器錯誤」完整排查與修復指南

錯誤分類與核心對策

「/ 應用程式中的伺服器錯誤」是通用錯誤頁面,實際原因隱藏在詳細資訊中。核心對策兩步走:

  1. 開啟詳細錯誤:獲取真實異常堆疊
  2. 對症修復:針對具體異常類型處理

步驟一:開啟詳細錯誤資訊

方法 1:Web.config 配置 (推薦)

<configuration>
  <system.web>
    <!-- 開發/測試環境:顯示完整錯誤 -->
    <customErrors mode="Off" />
    
    <!-- 生產環境:友善頁面 + 記錄詳細日誌 -->
    <!-- <customErrors mode="RemoteOnly" defaultRedirect="~/Error/General.aspx">
         <error statusCode="404" redirect="~/Error/404.aspx" />
         <error statusCode="500" redirect="~/Error/500.aspx" />
       </customErrors> -->
       
    <!-- 關鍵:編譯除錯資訊 -->
    <compilation debug="true" targetFramework="4.8" />
  </system.web>
  
  <!-- IIS 7+ 整合管線錯誤頁面 -->
  <system.webServer>
    <httpErrors errorMode="Detailed" existingResponse="PassThrough" />
  </system.webServer>
</configuration>

方法 2:本地瀏覽器直接訪問

遠端請求預設隱藏詳細錯誤,在伺服器本機瀏覽器打開 `https://localhost/...` 可見完整堆疊。

高頻錯誤類型與修復方案

1. 配置錯誤:無法識別的配置節 connectionStrings

剖析器錯誤: 無法識別的配置節 "connectionStrings"
來源錯誤:
行 14: <connectionStrings>
行 15: <add name="..." ... />

原因:.NET Framework 版本不匹配。`connectionStrings` 需 .NET 2.0+,但應用程式池設為 .NET 1.1。

修復:IIS → 應用程式池 → 基本設定 → .NET Framework 版本 → **v2.0 / v4.0** (非 v1.1)。

2. 權限錯誤:存取被拒絕 / 未授權

System.UnauthorizedAccessException: 存取路徑 'C:\Inetpub\wwwroot\App_Data\data.mdf' 被拒絕。

修復:授予應用程式池身分讀寫權限:

# PowerShell (管理員)
$path = "C:\Inetpub\wwwroot\YourApp"
$identity = "IIS APPPOOL\YourAppPoolName"  # 或 NETWORK SERVICE
icacls $path /grant $identity":(OI)(CI)F" /t
  • `(OI)(CI)`:物件繼承、容器繼承(遞歸套用檔案/資料夾)
  • `F`:完全控制 (讀/寫/刪除/修改權限)
  • 關鍵目錄:`App_Data`、上傳目錄、日誌目錄、暫存目錄

3. 經典/整合管線模式不匹配

HTTP Error 500.21 - Internal Server Error
處理常式 "ExtensionlessUrlHandler-Integrated-4.0" 在其模組列表中有錯誤的預處理條件

修復:應用程式池 → 進階設定 → 托管管線模式 → **整合** (ASP.NET 4.0+ 標準) 或 **經典** (舊版相容)。

4. 目標框架版本缺失

HTTP Error 500.19 - Internal Server Error
錯誤碼 0x8007000d
配置節 "system.webServer" 無法讀取,因缺少區段聲明

修復:安裝對應 .NET Framework 版本,或執行 `aspnet_regiis -i` (IIS 7+) / `dism /online /enable-feature /featurename:IIS-ASPNET45` (Win8+/Server 2012+)。

5. Web.config 格式/語法錯誤

  • XML 不井然(未閉合標籤、特殊字符未轉義 `&` `<` `>`)
  • 重複區段聲明
  • 鎖定區段被覆寫(需在 `applicationHost.config` 解鎖)

工具:VS 開啟 Web.config 自動驗證、線上 XML 驗證器。

6. 依賴組件缺失/版本衝突

Could not load file or assembly 'Newtonsoft.Json, Version=12.0.0.0...' 
或
Method not found: 'Void SomeLibrary.Method()'

修復:

  • NuGet 還原套件 / `dotnet restore`
  • 檢查 `bin` 目錄實際 DLL 版本
  • Binding Redirect (Web.config):
    ``
  • 清理方案 → 重建、刪除 `bin`/`obj` 重新建置

權限問題通用修復腳本

@echo off
REM fix_permissions.bat - 以管理員身分執行
set APP_PATH=C:\Inetpub\wwwroot\YourApp
set APP_POOL=YourAppPoolName

echo 設定應用程式池身分權限...
icacls "%APP_PATH%" /grant "IIS APPPOOL\%APP_POOL%":(OI)(CI)F /t /c /q

echo 設定 App_Data 特殊權限...
icacls "%APP_PATH%\App_Data" /grant "IIS APPPOOL\%APP_POOL%":(OI)(CI)F /t /c /q

echo 設定上傳目錄權限...
if exist "%APP_PATH%\Uploads" icacls "%APP_PATH%\Uploads" /grant "IIS APPPOOL\%APP_POOL%":(OI)(CI)F /t /c /q

echo 設定日誌目錄權限...
if exist "%APP_PATH%\Logs" icacls "%APP_PATH%\Logs" /grant "IIS APPPOOL\%APP_POOL%":(OI)(CI)F /t /c /q

echo 完成。請執行 iisreset 重啟 IIS。
pause

生產環境錯誤處理最佳實踐

<configuration>
  <system.web>
    <customErrors mode="RemoteOnly" defaultRedirect="~/Error/500.aspx">
      <error statusCode="404" redirect="~/Error/404.aspx" />
      <error statusCode="403" redirect="~/Error/403.aspx" />
    </customErrors>
    
    <!-- 全域異常處理 (Global.asax Application_Error) -->
    <!-- 健康檢查端點 -->
  </system.web>
  
  <system.webServer>
    <httpErrors errorMode="Custom" existingResponse="Replace">
      <remove statusCode="404" />
      <remove statusCode="500" />
      <error statusCode="404" path="/Error/404" responseMode="ExecuteURL" />
      <error statusCode="500" path="/Error/500" responseMode="ExecuteURL" />
    </httpErrors>
  </system.webServer>
</configuration>

結語

伺服器錯誤不可怕,可怕的是看不見真實錯誤。**開啟詳細錯誤 → 定位異常類型 → 對症修復 → 關閉詳細錯誤 → 部署友善錯誤頁** 是標準流程。權限問題佔比超過 50%,掌握 `icacls` / `IIS APPPOOL\Name` 身分機制是 IIS 部署必備技能。

copyright © 萬盛學電腦網 all rights reserved