asp.net core 使用 TestServer 來做集成測試

Intro

之前我的項目里的集成測試是隨機一個端口，每次都真實的啟動一個 WebServer，之前也有看到過微軟文檔上 TestServer 的介紹，當時沒仔細看過以為差不多就沒用，一直是啟動了一個真正的 WebServer 去跑集成測試的，上次分享 Xunit.DependencyInjection 改造測試項目的時候，寫的爛代碼被大師看到了之后，大師建議用 TestServer 來做集成測試，使用 TestServer 不會真正的占用端口號，不會出現權限問題，於是扒了扒 TestServer 的源碼，並用 TestServer 改進了集成測試項目，感謝大師[獻花鮮花]~~

Sample

之前的集成測試監聽了一個端口號，使用了一個真實的 WebServer，下面改成使用 TestServer

TestServer 現在是在 Microsoft.AspNetCore.TestHost 這個 Nuget 包中，引用這個包就可以使用了

在服務注冊的時候調用 UseTestServer 這一擴展方法就可以注入 TestServer 了，集成測試一般會用 HttpClient 來請求服務器端的 API 地址或頁面，TestServer 提供了一個方便的 CreateClient 的方法可以很方便的創建一個用來請求 TestServer 的 HttpClient，微軟也提供了一些比較方便的擴展方法，可以使用 IHost 的 GetTestClient 擴展方法來獲取 HttpClient

改成使用 TestServer 很簡單，引用 nuget 包 Microsoft.AspNetCore.TestHost，變更對比如下：

diff

源碼概覽

TestServer 在啟動的時候並沒有監聽端口，可以參考源碼 IServer 的 Start

TestServer 通過 CreateClient 方法來創建調用 TestServer 接口的 HttpClient

通過上面的代碼可以看的出來核心代碼是在 ClientHandler 中定義的，源碼有點多，詳細可以直接看源碼 https://github.com/dotnet/aspnetcore/blob/v5.0.0/src/Hosting/TestHost/src/ClientHandler.cs#L58

ClientHandler 重寫了 HttpClientHandler 的 SendAsync 方法，使得請求直接攔截掉，不會真正的發生 Http 請求，實際的請求過程首先將 Http 請求的信息轉換成 HttpRquestFeature 然后直接交給 TestServer 處理，其實也就是直接交給 asp.net core 的請求管道去處理，請求處理結束之后，獲取 HttpContext 響應，獲取 HttpResponseFeature 然后轉換成 HttpClient 需要的 HttpResponseMessage.

TestServer 不僅僅可以支持 HTTP 請求的處理，還支持 WebSocket 的處理，WebSocket 的集成測試也可以使用 TestServer 來處理。

你如果還是比較懷疑是否真的沒有 HTTP 請求，可以用 Fildder 之類的 HTTP 抓包工具監控在跑測試的期間是否真的有 HTTP 請求，如果是真正的 WebServer 會有 HTTP 請求，TestServer 不會有 HTTP 請求。

Reference

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。

猜您在找 ASP.NET Core 集成測試 ASP.NET Core Web API 集成測試 ASP.NET Core Web API 集成測試中使用 Bearer Token .NET Core 3.0 單元測試與 Asp.Net Core 3.0 集成測試 ASP.NET 5 使用 TestServer 進行單元測試 ASP.NET Core 中文文檔第五章測試（5.2）集成測試 Asp.Net Core 輕松學-利用xUnit進行主機級別的網絡集成測試 ASP.NET Core 集成測試中模擬登錄用戶的一種姿勢 ASP.NET CORE 2.* 利用集成測試框架覆蓋HttpClient相關代碼 ASP.NET Core搭建多層網站架構【12-xUnit單元測試之集成測試】