產業新聞

遷移到 .NET 11?請先檢查以下重大變更

Curtis Chau
Curtis Chau
已更新: 2026年8月31日

.NET 11 即將推出,重大變更列表已經上線。我們逐行檢查,以便您在升級時知道要注意什麼。

這是個好消息,但也使得遷移測試變得更加重要。

許多應用程式在重新定位到 .NET 11 後仍能乾淨地編譯。更大的風險在於行為變更:成功構建的代碼在運行時可能會拋出新的異常、以不同方式處理數據或產生略有不同的結果。

本指南不會逐一介紹每個兼容性項目,而是重點關注最有可能影響實際應用程式的變更,以及在投入生產之前應測試的內容。

一覽無遺的表格

變更發生什麼事
ZIP 讀取驗證 CRC32在損壞的條目上拋出 InvalidDataException
DateOnly/TimeOnly TryParse在無效格式或樣式上拋出
BackgroundService 失敗主機在啟動/關閉時拋出
Math.Round 正確性返回正確四捨五入的結果
共享框架中的擴展程序集版本解析可能會改變
構建和測試工具VSTest、NuGet、模板引擎變更

我們首先檢查的:ZIP 讀取現在會拋出

這是最有可能讓文件密集型代碼庫感到驚訝的變更,因為它在不發生時是無聲的。從 .NET 11 開始,System.IO.Compression 在您讀取 ZIP 條目時驗證 CRC32 校驗和,如果存儲的校驗和與數據不匹配,則拋出 InvalidDataException。以前,損壞或被篡改的條目會直接讀取而不會有任何抱怨。

這是一個真正好的變更,您希望知道文件何時出錯,但如果您的應用程式從用戶、合作夥伴或舊存儲桶中接收 ZIP 文件,運行多年的代碼可能會開始拋出。修復很小:將您的讀取包裹在 InvalidDataException 的 try-catch 中,並決定如何處理壞的存檔。最好有意識地捕捉它,而不是在生產中發現它。

隱蔽的:TryParse 現在可能會拋出

每個 .NET 開發人員都已經內化 TryParse 永遠不會拋出,它返回一個布爾值。在 .NET 11 中,DateOnly.TryParse、TimeOnly.TryParse 及其 TryParseExact 兄弟稍微打破了這個習慣:傳遞無效的 DateTimeStyles 值或錯誤的格式規範符,它們現在拋出 ArgumentException 而不是安靜地返回 false。如果您的格式字符串和樣式是硬編碼且有效的,則不會有任何變化。如果它們是在運行時計算的或來自用戶輸入,那就是一個新的異常路徑需要覆蓋。

僅在相關時檢查

其餘的範圍較窄,按其所在位置分組:

  • ASP.NET Core。 多年前標記為過時的舊 Blazor API 不再編譯。Kestrel 對格式錯誤的 HTTP 標頭更嚴格。如果您的 SQL 連接字符串使用 Entra ID (Active Directory) 認證,您現在需要 Microsoft.Data.SqlClient.Extensions.Azure 包,這也會影響 EF Core SQL Server 用戶。
  • 擴展和託管。 工作服務失敗更明顯:如果 BackgroundService 拋出,主機也會拋出,因此請測試您的啟動路徑。
  • 核心庫。 Math.Round 和複數變得更加符合標準,這只有在測試期望舊值時才重要。
  • 構建和工具。 VSTest 放棄 Newtonsoft.Json,模板包放棄 netstandard2.0。這些會以構建錯誤的形式出現,因此它們會自我宣告。
  • 平台。 最低 CPU 要求提高,.NET MAUI 需要 Android API 24,默認情況下關閉 TLS 服務器端證書提取。您會知道這些是否與您相關。

您不必擔心的一件事

當您正在審核 .NET 11 的相容性時,您的文件工具不應該在清單上。Iron Suite 函式庫是純管理的 .NET,已經可以在 .NET 11 到 .NET Framework 上運行,因此 IronPDF、IronXL 和套件中的其他工具會隨著您的應用程式一起移動,而不是阻礙它。值得注意的是,上述 ZIP 變更正好位於這些函式庫取代的文件處理代碼旁邊,如果您有手動編寫的文件或壓縮檔案處理,遷移是一個自然的時機,可以將這部分交給已經追蹤每個 .NET 發行版本的函式庫。

完整清單,包括獨立頁面的 ASP.NET Core 變更,Microsoft .NET 11 重大變更參考 是值得加書籤的來源。我們將隨著清單的增長更新這篇文章,因為它仍在填充中。