一、開篇引入

在當今的 Web 應用開發領域，前后端分離開發模式已成為主流趨勢。這種模式就像是一場高效的接力賽，前端專注于打造用戶界面，為用戶帶來絕佳的視覺與交互體驗；而后端則承擔起數據處理、業務邏輯實現以及服務提供的重任，是整個應用的堅實后盾。就好比建造一座高樓，前端是這座樓華麗的外觀與精致的內飾，而后端則是穩固的地基和承重結構。

后端開發技術的重要性不言而喻，它直接關系到應用程序的性能、穩定性和安全性。打個比方，后端開發就如同餐廳的廚房，前端展示的是精致的菜品，而后端則是在幕后精心準備食材、烹飪美食的地方。沒有一個高效、穩定的廚房（后端），前端即便再吸引人，也無法持續為用戶提供優質的服務。

在眾多后端開發技術中，.NET Core WebApi 脫穎而出，它憑借自身的眾多優勢，成為了開發者們構建強大后端服務的得力工具。接下來，就讓我們一起深入探索.NET Core WebApi 的精彩世界。

二、.NET Core WebApi 是什么

（一）.NET Core 簡介

.NET Core 是微軟開發的一個開源、通用的開發框架，旨在為開發者提供一個高效、靈活且跨平臺的開發環境。它就像是一個萬能的工具箱，里面裝滿了各種工具和組件，能幫助開發者輕松打造出各種類型的應用程序。

其最顯著的特性之一便是跨平臺能力。以往，基于.NET Framework 開發的應用往往被限制在 Windows 系統中運行，就如同被束縛在一個小圈子里。而.NET Core 打破了這一限制，它可以在 Windows、Linux 和 macOS 等多種操作系統上運行，就像一位自由的旅行者，可以在不同的土地上自由穿梭。這使得開發者能夠更廣泛地部署應用，滿足不同用戶群體的需求，無論是企業級的服務器應用，還是個人開發的小型項目，.NET Core 都能完美適配。

在實際應用場景中，.NET Core 被廣泛應用于云服務、微服務架構以及各類 Web 應用的開發。以云服務為例，許多企業將業務遷移到云端，.NET Core 憑借其高效的性能和跨平臺特性，能夠輕松部署在各種云平臺上，如 Microsoft Azure、AWS 等，為企業提供穩定可靠的服務。在微服務架構中，各個微服務可以獨立開發、部署和擴展，.NET Core 的輕量級和模塊化設計使其非常適合構建這種分布式的系統架構，每個微服務都可以專注于自己的業務邏輯，通過高效的通信機制協同工作，就像一個精密的機器，各個零部件各司其職，共同推動整個系統的運轉。

（二）WebApi 在開發中的角色

WebApi 在前后端分離開發模式中扮演著至關重要的數據交互橋梁角色。簡單來說，前端負責呈現精美的界面，與用戶進行交互，而后端則負責處理業務邏輯和數據存儲。WebApi 就像是連接前后端的高速公路，讓數據能夠在兩者之間快速、準確地傳輸。

想象一下，你在手機上使用一款購物 APP，當你點擊查看商品詳情時，前端界面會向 WebApi 發送請求，WebApi 接收到請求后，會在后端的數據庫中查詢相關商品信息，然后將這些信息以特定的格式（如 JSON）返回給前端，前端再根據這些數據將商品詳情展示在你的屏幕上。這個過程中，WebApi 提供了一系列的數據接口，這些接口就像是高速公路上的一個個出口，前端可以根據不同的需求，通過相應的接口獲取或操作數據。

在實際開發中，WebApi 通常會定義各種不同的 API 端點，每個端點對應著不同的業務功能。比如，一個用戶管理系統的 WebApi 可能會有 “/api/users/login” 用于用戶登錄，“/api/users/register” 用于用戶注冊，“/api/users/{id}” 用于獲取特定用戶的信息等接口。通過這些清晰明確的接口，前端開發者可以方便地與后端進行交互，而無需關心后端復雜的業務邏輯和數據處理過程，就像你只需要知道如何使用高速公路上的出口到達目的地，而不需要了解高速公路的建設和維護細節一樣。

三、開發環境搭建

（一）開發工具推薦

在進行.NET Core WebApi 開發時，選擇一款合適的開發工具能讓你的開發之旅更加順暢。以下是幾款常用的開發工具及其優勢：

• Visual Studio

  ：這是一款由微軟開發的功能強大的集成開發環境（IDE），就像是一個超級工具箱，里面應有盡有。它對.NET Core 有著原生的支持，提供了豐富的代碼編輯、調試和項目管理功能。在代碼編輯方面，它擁有智能代碼提示功能，就像你的私人助手，能根據你的輸入自動提示可能需要的代碼，大大提高了編碼效率。調試功能更是強大，你可以設置斷點，逐行執行代碼，查看變量的值，輕松定位和解決代碼中的問題，就像拿著一個放大鏡，仔細檢查代碼中的每一個細節。下載安裝也很簡單，你可以在微軟官網（https://visualstudio.microsoft.com/zh-hans/downloads/）下載，根據安裝向導的提示，一步步完成安裝。安裝過程中，你可以根據自己的需求選擇安裝的組件，比如你主要進行.NET Core WebApi 開發，就可以選擇安裝相關的 Web 開發組件等。

• Visual Studio Code

  ：這是一款輕量級但功能強大的源代碼編輯器，它的特點是跨平臺，無論你使用的是 Windows、macOS 還是 Linux 系統，都可以流暢使用。它擁有豐富的插件生態系統，這就像是一個巨大的插件超市，你可以根據自己的開發需求安裝各種插件。比如，安裝 C# 插件后，它就能很好地支持.NET Core 開發，提供代碼高亮、智能補全等功能。你可以在官網（https://code.visualstudio.com/）下載安裝包，安裝完成后，在擴展商店中搜索并安裝 C# 插件，即可開始.NET Core WebApi 的開發。

• Rider

  ：這是 JetBrains 公司開發的一款跨平臺的.NET IDE，它以其智能的代碼分析和豐富的代碼導航功能而受到開發者的喜愛。它能快速分析你的代碼，找出潛在的問題和優化建議，就像一個專業的代碼醫生，為你的代碼健康保駕護航。在代碼導航方面，你可以輕松跳轉到定義、查看引用等，方便你理解和管理代碼結構。你可以在 JetBrains 官網（https://www.jetbrains.com/rider/）下載安裝，安裝完成后，就可以創建.NET Core WebApi 項目進行開發了。

（二）創建第一個.NET Core WebApi 項目

接下來，我們以 Visual Studio 為例，一步步創建一個.NET Core WebApi 項目。

1. 打開 Visual Studio

   ：安裝完成后，在開始菜單中找到 Visual Studio 并打開它。第一次打開時，可能會進行一些初始化設置，比如選擇主題、設置環境等，你可以根據自己的喜好進行選擇。

1. 創建新項目

   ：點擊 “創建新項目”，在彈出的 “創建新項目” 窗口中，你會看到各種各樣的項目模板。在搜索框中輸入 “ASP.NET Core Web API”，然后在搜索結果中選擇 “ASP.NET Core Web API” 模板，這個模板就是專門用于創建.NET Core WebApi 項目的，就像你找到了一把專門打開 WebApi 項目大門的鑰匙。點擊 “下一步”。

1. 配置項目信息

   ：在這一步，你需要給項目命名，比如 “FirstWebApiProject”，同時選擇項目的存儲位置，建議選擇一個空間較大且便于管理的磁盤目錄，比如 D 盤的某個文件夾。還可以根據需要設置解決方案名稱，解決方案是一個容器，它可以包含多個項目，這里我們可以保持默認與項目名稱相同。設置完成后，點擊 “下一步”。

1. 選擇框架和其他配置

   ：在這個界面，你可以選擇.NET Core 的版本，比如選擇最新穩定版本，以獲得更好的性能和功能支持。還可以配置身份驗證類型、是否配置 HTTPS 等。對于初學者，我們可以先保持默認設置，這些配置在后續的開發中也可以根據實際需求進行調整。點擊 “創建” 按鈕。

1. 等待項目創建完成

   ：Visual Studio 會根據你選擇的模板和配置，自動創建項目。這個過程可能需要一些時間，就像在搭建一座房子，需要逐步構建各個部分。創建完成后，你會看到一個完整的項目結構，其中包含了各種文件和文件夾，如 Controllers 文件夾用于存放控制器，Models 文件夾用于存放數據模型，Program.cs 是項目的入口文件，它負責啟動應用程序等。

四、核心開發技術解析

（一）控制器與路由

在.NET Core WebApi 中，控制器就像是交通樞紐的調度員，負責接收客戶端發送的 HTTP 請求，并根據請求的內容來執行相應的操作，然后將處理結果返回給客戶端。它是整個 WebApi 的核心組件之一，將業務邏輯與外部請求進行了有效的連接。

以一個簡單的用戶管理系統為例，我們來創建一個控制器。首先，在 Controllers 文件夾下創建一個名為 UserController.cs 的文件。在這個文件中，我們定義一個類，讓它繼承自 ControllerBase 類，這樣它就具備了 WebApi 控制器的能力。

using Microsoft.AspNetCore.Mvc;
namespace FirstWebApiProject.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class UserController : ControllerBase
    {
// 獲取所有用戶
        [HttpGet]
        public IActionResult GetAllUsers()
        {
// 這里可以編寫從數據庫獲取所有用戶的邏輯，暫時返回一個簡單的模擬數據
            var users = new[] { new { Name = "張三", Age = 20 }, new { Name = "李四", Age = 22 } };
            return Ok(users);
        }
// 根據ID獲取單個用戶
        [HttpGet("{id}")]
        public IActionResult GetUserById(int id)
        {
// 同樣，這里可以編寫從數據庫根據ID查詢用戶的邏輯，這里簡單模擬
            var user = new { Name = "模擬用戶", Age = 25 };
            return Ok(user);
        }
// 添加新用戶
        [HttpPost]
        public IActionResult AddUser([FromBody] dynamic user)
        {
// 處理添加用戶的邏輯，這里簡單返回添加成功的信息
            return Ok($"用戶 {user.Name} 添加成功");
        }
// 更新用戶信息
        [HttpPut("{id}")]
        public IActionResult UpdateUser(int id, [FromBody] dynamic user)
        {
// 處理更新用戶信息的邏輯，這里簡單返回更新成功的信息
            return Ok($"用戶 {id} 的信息更新成功");
        }
// 刪除用戶
        [HttpDelete("{id}")]
        public IActionResult DeleteUser(int id)
        {
// 處理刪除用戶的邏輯，這里簡單返回刪除成功的信息
            return Ok($"用戶 {id} 刪除成功");
        }
    }
}

在上述代碼中，我們定義了多個方法，每個方法對應一種 HTTP 請求方式和相應的業務邏輯。比如，GetAllUsers方法用于處理獲取所有用戶的 GET 請求，AddUser方法用于處理添加用戶的 POST 請求等。

路由則決定了客戶端的請求如何被映射到相應的控制器和操作方法上。在上面的代碼中，[Route("api/[controller]")]表示該控制器的路由前綴為 “api/” 加上控制器的名稱（去掉 Controller 后綴）。例如，對于 UserController，其路由前綴就是 “api/user”。[HttpGet]、[HttpPost]等特性則進一步指定了方法對應的 HTTP 請求方式。[HttpGet("{id}")]表示這個方法處理帶有一個參數id的 GET 請求，比如 “api/user/1”，這里的 “1” 就是id的值。

不同的路由規則有著不同的應用場景。例如，屬性路由（如上面代碼中使用的）適用于構建 RESTful 風格的 API，它能讓 API 的 URL 更加直觀和易于理解，通過 URL 就能清晰地知道請求的目的和操作的資源。而傳統路由則更適合一些對 URL 格式有特定要求，或者需要進行復雜路由匹配的場景。比如，在一個大型的企業級應用中，可能需要根據不同的模塊、權限等因素來進行路由匹配，傳統路由可以通過在 Startup.cs 文件中進行詳細的配置來滿足這些需求。

（二）請求與響應處理

在 WebApi 中，常見的 HTTP 請求方式有 GET、POST、PUT、DELETE 等，每種請求方式都有其特定的用途。

GET 請求通常用于從服務器獲取資源。比如，在上面的 UserController 中，GetAllUsers方法和GetUserById方法都是處理 GET 請求的。當客戶端發送一個 GET 請求到 “api/user” 時，GetAllUsers方法會被調用，返回所有用戶的信息；當發送 GET 請求到 “api/user/1” 時，GetUserById方法會被調用，返回 ID 為 1 的用戶信息。在實際應用中，GET 請求還可以帶有查詢參數，用于對獲取的資源進行篩選、排序等操作。比如 “api/user?age=20”，表示獲取年齡為 20 的用戶信息。

POST 請求一般用于向服務器提交數據，以創建新的資源。在AddUser方法中，我們使用[FromBody]特性來獲取客戶端發送的請求體中的數據，這些數據就是要添加的新用戶的信息。服務器接收到 POST 請求后，會根據請求體中的數據在數據庫中創建一個新的用戶記錄，并返回相應的結果給客戶端，告知客戶端添加操作是否成功。

PUT 請求用于更新服務器上已有的資源。UpdateUser方法接收一個id參數和請求體中的更新數據，根據id找到對應的用戶，然后將請求體中的數據應用到該用戶上，實現用戶信息的更新。

DELETE 請求自然是用于刪除服務器上的資源啦。DeleteUser方法根據傳入的id，在數據庫中刪除對應的用戶記錄，并返回刪除成功的響應給客戶端。

當 WebApi 接收到客戶端的請求并處理完成后，需要構建正確的響應返回給客戶端。響應通常包括狀態碼、響應頭和響應體。狀態碼用于表示請求的處理結果，比如 200 表示請求成功，404 表示資源未找到，500 表示服務器內部錯誤等。在上面的代碼中，我們使用Ok方法來返回 200 狀態碼和相應的響應體。如果請求處理過程中出現錯誤，我們可以使用BadRequest方法返回 400 狀態碼，表示客戶端請求錯誤，或者使用NotFound方法返回 404 狀態碼，表示請求的資源不存在等。響應頭則包含了一些關于響應的元信息，比如 Content-Type 用于指定響應體的數據類型，常見的有 application/json、text/html 等。如果響應體是 JSON 格式的數據，就需要將 Content-Type 設置為 application/json，這樣客戶端才能正確解析響應體中的數據。

（三）數據訪問與持久化

在實際的 WebApi 開發中，數據訪問與持久化是非常重要的環節。接下來，我們簡單介紹一下如何連接常見的數據庫（如 SQL Server、MySQL）并進行數據的增刪改查操作。

以 SQL Server 為例，我們可以使用ADO.NET來連接數據庫。首先，需要在項目中添加對System.Data.SqlClient命名空間的引用。然后，在控制器或數據訪問層的代碼中，編寫連接數據庫和執行操作的代碼。

using System;
using System.Data.SqlClient;
public class UserRepository
{
    private readonly string connectionString;
    public UserRepository(string connectionString)
    {
        this.connectionString = connectionString;
    }
// 獲取所有用戶
    public SqlDataReader GetAllUsers()
    {
        string query = "SELECT * FROM Users";
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            SqlCommand command = new SqlCommand(query, connection);
            connection.Open();
            return command.ExecuteReader();
        }
    }
// 根據ID獲取單個用戶
    public SqlDataReader GetUserById(int id)
    {
        string query = "SELECT * FROM Users WHERE Id = @Id";
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            SqlCommand command = new SqlCommand(query, connection);
            command.Parameters.AddWithValue("@Id", id);
            connection.Open();
            return command.ExecuteReader();
        }
    }
// 添加新用戶
    public int AddUser(string name, int age)
    {
        string query = "INSERT INTO Users (Name, Age) VALUES (@Name, @Age); SELECT SCOPE_IDENTITY();";
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            SqlCommand command = new SqlCommand(query, connection);
            command.Parameters.AddWithValue("@Name", name);
            command.Parameters.AddWithValue("@Age", age);
            connection.Open();
            return Convert.ToInt32(command.ExecuteScalar());
        }
    }
// 更新用戶信息
    public int UpdateUser(int id, string name, int age)
    {
        string query = "UPDATE Users SET Name = @Name, Age = @Age WHERE Id = @Id";
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            SqlCommand command = new SqlCommand(query, connection);
            command.Parameters.AddWithValue("@Id", id);
            command.Parameters.AddWithValue("@Name", name);
            command.Parameters.AddWithValue("@Age", age);
            connection.Open();
            return command.ExecuteNonQuery();
        }
    }
// 刪除用戶
    public int DeleteUser(int id)
    {
        string query = "DELETE FROM Users WHERE Id = @Id";
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            SqlCommand command = new SqlCommand(query, connection);
            command.Parameters.AddWithValue("@Id", id);
            connection.Open();
            return command.ExecuteNonQuery();
        }
    }
}

在上述代碼中，UserRepository類封裝了對用戶數據的各種操作。通過構造函數傳入數據庫連接字符串，然后在各個方法中使用SqlConnection、SqlCommand等類來連接數據庫、執行 SQL 語句。比如，GetAllUsers方法執行一條查詢所有用戶的 SQL 語句，并返回一個SqlDataReader對象，用于讀取查詢結果；AddUser方法執行一條插入新用戶的 SQL 語句，并返回插入的新用戶的 ID。

如果要連接 MySQL 數據庫，我們可以使用 MySql.Data.MySqlClient 命名空間。首先，需要在項目中安裝 MySQL 的.NET 驅動，可以通過 NuGet 包管理器來安裝。安裝完成后，編寫如下代碼：

using System;
using MySql.Data.MySqlClient;
public class UserRepository
{
    private readonly string connectionString;
    public UserRepository(string connectionString)
    {
        this.connectionString = connectionString;
    }
// 獲取所有用戶
    public MySqlDataReader GetAllUsers()
    {
        string query = "SELECT * FROM Users";
        using (MySqlConnection connection = new MySqlConnection(connectionString))
        {
            MySqlCommand command = new MySqlCommand(query, connection);
            connection.Open();
            return command.ExecuteReader();
        }
    }
// 根據ID獲取單個用戶
    public MySqlDataReader GetUserById(int id)
    {
        string query = "SELECT * FROM Users WHERE Id = @Id";
        using (MySqlConnection connection = new MySqlConnection(connectionString))
        {
            MySqlCommand command = new MySqlCommand(query, connection);
            command.Parameters.AddWithValue("@Id", id);
            connection.Open();
            return command.ExecuteReader();
        }
    }
// 添加新用戶
    public int AddUser(string name, int age)
    {
        string query = "INSERT INTO Users (Name, Age) VALUES (@Name, @Age); SELECT LAST_INSERT_ID();";
        using (MySqlConnection connection = new MySqlConnection(connectionString))
        {
            MySqlCommand command = new MySqlCommand(query, connection);
            command.Parameters.AddWithValue("@Name", name);
            command.Parameters.AddWithValue("@Age", age);
            connection.Open();
            return Convert.ToInt32(command.ExecuteScalar());
        }
    }
// 更新用戶信息
    public int UpdateUser(int id, string name, int age)
    {
        string query = "UPDATE Users SET Name = @Name, Age = @Age WHERE Id = @Id";
        using (MySqlConnection connection = new MySqlConnection(connectionString))
        {
            MySqlCommand command = new MySqlCommand(query, connection);
            command.Parameters.AddWithValue("@Id", id);
            command.Parameters.AddWithValue("@Name", name);
            command.Parameters.AddWithValue("@Age", age);
            connection.Open();
            return command.ExecuteNonQuery();
        }
    }
// 刪除用戶
    public int DeleteUser(int id)
    {
        string query = "DELETE FROM Users WHERE Id = @Id";
        using (MySqlConnection connection = new MySqlConnection(connectionString))
        {
            MySqlCommand command = new MySqlCommand(query, connection);
            command.Parameters.AddWithValue("@Id", id);
            connection.Open();
            return command.ExecuteNonQuery();
        }
    }
}

這段代碼與連接 SQL Server 的代碼類似，只是使用了 MySql.Data.MySqlClient 命名空間下的類來連接 MySQL 數據庫并執行操作。通過這些代碼，我們可以在.NET Core WebApi 中實現對 SQL Server 和 MySQL 數據庫的基本數據訪問與持久化操作。

五、實用開發技巧

（一）日志記錄

在.NET Core WebApi 開發中，日志記錄就像是飛機上的黑匣子，它詳細記錄著項目運行過程中的各種信息，對于項目的調試和問題排查起著至關重要的作用。通過日志，我們可以了解到請求的處理過程、數據的流轉情況以及是否發生了錯誤等。比如，當程序出現異常時，日志可以記錄下異常發生的時間、位置以及詳細的錯誤信息，幫助我們快速定位問題所在。

在.NET Core 中，有多種工具可以幫助我們實現日志記錄功能，其中比較常用的有 Serilog 和 NLog。以 Serilog 為例，我們可以通過以下步驟來配置和使用它。

首先，在項目中安裝 Serilog 相關的 NuGet 包。打開項目的 “解決方案資源管理器”，右鍵點擊項目名稱，選擇 “管理 NuGet 程序包”，在彈出的窗口中搜索 “Serilog.AspNetCore”，然后點擊安裝。

安裝完成后，在項目的入口文件（通常是 Program.cs）中進行配置。在創建 WebApplicationBuilder 時，添加如下代碼：

using Serilog;
var builder = WebApplication.CreateBuilder(args);
builder.Host.UseSerilog((ctx, lc) => lc
.WriteTo.Console()
.WriteTo.File("logs/log.txt", rollingInterval: RollingInterval.Day));

上述代碼中，我們使用UseSerilog方法來配置 Serilog。WriteTo.Console()表示將日志輸出到控制臺，這樣在開發過程中，我們可以直接在控制臺看到日志信息，方便調試。WriteTo.File("logs/log.txt", rollingInterval: RollingInterval.Day)則表示將日志寫入到文件中，文件名為 “logs/log.txt”，并且每天生成一個新的日志文件，這樣可以避免日志文件過大，同時也便于管理和查看歷史日志。

在控制器中，我們可以通過依賴注入獲取ILogger對象來記錄日志。例如：

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;
[ApiController]
[Route("api/[controller]")]
public class UserController : ControllerBase
{
    private readonly ILogger<UserController> _logger;
    public UserController(ILogger<UserController> logger)
    {
        _logger = logger;
    }
    [HttpGet]
    public IActionResult Get()
    {
        _logger.LogInformation("獲取用戶列表的請求被處理");
// 處理業務邏輯
        return Ok();
    }
}

在上述代碼中，_logger.LogInformation("獲取用戶列表的請求被處理")這行代碼記錄了一條信息日志，表示獲取用戶列表的請求被處理，這樣在查看日志時，我們就可以清楚地知道請求的處理情況。

（二）異常處理

在程序運行過程中，異常就像是路上的絆腳石，隨時可能導致程序崩潰。而全局異常處理機制就像是一個保護罩，能夠捕獲這些異常，避免程序崩潰，確保系統的穩定性。

在.NET Core WebApi 中，我們可以通過中間件或過濾器來實現全局異常處理。下面以過濾器為例進行講解。

首先，創建一個自定義的異常過濾器。在項目中新建一個文件夾，比如 “Filters”，在該文件夾下創建一個類，例如 “GlobalExceptionFilter.cs”，代碼如下：

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;
using System;
public class GlobalExceptionFilter : IExceptionFilter
{
    public void OnException(ExceptionContext context)
    {
// 記錄異常日志，這里可以使用前面配置的日志記錄工具，如Serilog
// 假設已經在項目中配置好了Serilog，并且可以通過依賴注入獲取到ILogger對象
        var logger = context.HttpContext.RequestServices.GetService<ILogger<GlobalExceptionFilter>>();
        logger.LogError(context.Exception, "全局異常處理捕獲到異常");
// 根據異常類型返回不同的響應
        var statusCode = context.Exception switch
    {
// 這里可以根據自定義的異常類型進行映射，比如自定義了NotFoundException，表示資源未找到
// NotFoundException => StatusCodes.Status404NotFound,
// 這里只是簡單示例，實際應用中可以根據具體需求添加更多的異常類型映射
        _ => StatusCodes.Status500InternalServerError
    };
    context.Result = new ObjectResult(new { error = context.Exception.Message })
        {
            StatusCode = statusCode
        };
// 設置異常已處理，防止其他異常處理機制再次處理
        context.ExceptionHandled = true;
    }
}

在上述代碼中，OnException方法會在異常發生時被調用。我們首先記錄異常日志，然后根據異常類型設置不同的 HTTP 狀態碼，并返回包含錯誤信息的響應。最后，將context.ExceptionHandled設置為true，表示該異常已經被處理，避免其他異常處理機制重復處理。

接下來，需要將這個自定義的異常過濾器注冊到項目中。在 Startup.cs 文件的ConfigureServices方法中添加如下代碼：

services.AddControllers(options =>
{
  options.Filters.Add(typeof(GlobalExceptionFilter));
});

這樣，當項目中發生未處理的異常時，就會被GlobalExceptionFilter捕獲并處理，從而避免程序崩潰，提高系統的穩定性。

（三）緩存機制

緩存機制在提升系統性能方面有著神奇的效果，它就像是一個高速緩存區，能夠將經常訪問的數據存儲起來，當再次請求相同的數據時，直接從緩存中獲取，而不需要再次從數據庫或其他數據源中讀取，大大減少了數據讀取的時間，提高了系統的響應速度。

在.NET Core WebApi 中，我們可以使用內存緩存（IMemoryCache）來實現簡單的緩存功能。以獲取用戶信息為例，假設我們有一個方法從數據庫中獲取用戶信息，這個操作可能比較耗時。現在我們使用緩存來優化這個過程。

首先，在 Startup.cs 文件的ConfigureServices方法中添加內存緩存服務：

services.AddMemoryCache();

然后，在控制器中使用緩存。例如：

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Caching.Memory;
[ApiController]
[Route("api/[controller]")]
public class UserController : ControllerBase
{
    private readonly IMemoryCache _memoryCache;
    public UserController(IMemoryCache memoryCache)
    {
        _memoryCache = memoryCache;
    }
    [HttpGet("{id}")]
    public IActionResult GetUserById(int id)
    {
// 定義緩存鍵，通常根據請求的參數來生成，確保緩存鍵的唯一性
        var cacheKey = $"user_{id}";
// 嘗試從緩存中獲取用戶信息
        if (_memoryCache.TryGetValue(cacheKey, out object cachedUser))
        {
            return Ok(cachedUser);
        }
// 緩存中未找到，從數據庫中獲取用戶信息（這里假設存在一個從數據庫獲取用戶信息的方法）
        var user = GetUserFromDatabase(id);
// 將獲取到的用戶信息添加到緩存中，設置緩存的過期時間為10分鐘
        var cacheOptions = new MemoryCacheEntryOptions()
        .SetSlidingExpiration(TimeSpan.FromMinutes(10));
        _memoryCache.Set(cacheKey, user, cacheOptions);
        return Ok(user);
    }
// 模擬從數據庫獲取用戶信息的方法
    private object GetUserFromDatabase(int id)
    {
// 這里可以編寫實際的數據庫查詢邏輯，暫時返回一個簡單的模擬數據
        return new { Id = id, Name = "模擬用戶", Age = 25 };
    }
}

在上述代碼中，首先在控制器的構造函數中注入IMemoryCache對象。在GetUserById方法中，先根據緩存鍵嘗試從緩存中獲取用戶信息，如果獲取到了，直接返回緩存中的數據；如果緩存中沒有，則從數據庫中獲取用戶信息，然后將其添加到緩存中，并設置緩存的過期時間為 10 分鐘，最后返回獲取到的用戶信息。通過這種方式，下次再請求相同id的用戶信息時，就可以直接從緩存中獲取，大大提高了系統的響應性能。

六、項目部署發布

（一）發布前的準備工作

在將.NET Core WebApi 項目部署發布之前，嚴謹細致的準備工作是確保項目順利上線的關鍵。就像運動員在比賽前要檢查裝備、調整狀態一樣，我們需要對項目進行全面的檢查和配置。

首先，仔細檢查項目的配置文件，這是項目運行的基礎設置。以appsettings.json文件為例，其中可能包含數據庫連接字符串、日志配置等重要信息。確保數據庫連接字符串準確無誤，它就像是連接項目與數據庫的橋梁，一旦錯誤，項目將無法與數據庫進行正常通信。比如，如果使用的是 SQL Server 數據庫，連接字符串應類似這樣：

{
  "ConnectionStrings": {
    "DefaultConnection": "Data Source=YOUR_SERVER_NAME;Initial Catalog=YOUR_DATABASE_NAME;User ID=YOUR_USERNAME;Password=YOUR_PASSWORD"
  }
}

如果是其他類型的數據庫，如 MySQL，連接字符串的格式會有所不同，但同樣需要確保各項參數準確，包括服務器地址、數據庫名、用戶名和密碼等。

對于日志配置，要確認日志級別、日志輸出路徑等設置是否符合項目需求。比如，如果希望在開發階段記錄詳細的日志信息以便調試，可將日志級別設置為 “Debug”；而在生產環境中，為了減少日志文件的大小和提高系統性能，可能將日志級別設置為 “Information” 或 “Warning”。日志輸出路徑也要合理設置，確保有足夠的磁盤空間來存儲日志文件，并且方便后續查看和分析。

同時，進行全面的代碼審查和測試也是必不可少的環節。代碼審查可以發現潛在的代碼質量問題、安全漏洞以及不符合規范的地方。可以邀請團隊中的其他成員一起進行代碼審查，不同的視角可能會發現不同的問題。例如，在審查用戶認證相關的代碼時，要確保密碼加密方式安全可靠，防止密碼明文存儲帶來的安全風險。

測試方面，要涵蓋單元測試、集成測試和功能測試。單元測試用于測試單個方法或類的功能，確保每個小的代碼單元都能正常工作。比如，對于一個計算訂單總價的方法，通過編寫單元測試用例，傳入不同的訂單商品和價格，驗證計算結果是否正確。集成測試則關注不同模塊之間的協作，測試 WebApi 與數據庫、緩存等組件之間的交互是否正常。功能測試從用戶的角度出發，模擬用戶的操作，檢查系統是否滿足業務需求。比如，在一個電商系統中，進行功能測試時，模擬用戶注冊、登錄、添加商品到購物車、下單等一系列操作，檢查整個流程是否順暢，數據是否正確更新。

通過這些嚴格的檢查和測試，確保項目在發布前沒有錯誤和警告，為項目的成功部署發布奠定堅實的基礎。

（二）發布到 IIS 或其他服務器

接下來，我們以 IIS 為例，詳細介紹如何將.NET Core WebApi 項目部署到服務器上。IIS（Internet Information Services）是微軟提供的一種 Web 服務器，廣泛應用于 Windows 系統中，它就像是一個專業的網站托管平臺，能夠穩定地運行我們的 WebApi 項目。

1. 安裝 IIS

   ：如果服務器上尚未安裝 IIS，首先需要進行安裝。以 Windows Server 系統為例，打開 “服務器管理器”，點擊 “添加角色和功能”。在彈出的向導中，選擇 “基于角色或基于功能的安裝”，然后點擊 “下一步”。在 “服務器角色” 中，勾選 “Web 服務器（IIS）”，按照提示一步步完成安裝。這個過程就像是在搭建一個舞臺，為 WebApi 項目的展示做好準備。

1. 安裝.NET Core Hosting Bundle

   ：IIS 默認并不支持.NET Core 項目的運行，所以需要安裝.NET Core Hosting Bundle。這就像是給 IIS 安裝一個特殊的插件，讓它能夠識別和運行.NET Core 應用。你可以從微軟官方網站（https://dotnet.microsoft.com/download/dotnet-core/thank-you/runtime-aspnetcore-8.0.7-windows-hosting-bundle-installer）下載對應版本的安裝包，下載完成后，雙擊安裝包進行安裝，安裝過程中按照提示操作即可。

1. 在 Visual Studio 中發布項目

   ：回到我們的開發環境，在 Visual Studio 中，右鍵點擊項目名稱，選擇 “發布”。在彈出的 “發布” 窗口中，發布目標選擇 “文件系統”，然后點擊 “下一步”。在 “目標位置” 處，選擇一個本地文件夾來保存發布文件，這個文件夾就像是一個臨時的倉庫，存放著我們即將部署到服務器上的項目文件。點擊 “完成” 后，再點擊 “發布” 按鈕，Visual Studio 會將項目編譯并生成發布文件，這些文件包含了項目運行所需的所有代碼、配置文件和依賴項。

1. 配置 IIS 站點

   ：打開 IIS 管理器，在左側的 “連接” 面板中，右鍵點擊 “網站”，選擇 “添加網站”。在 “添加網站” 對話框中，輸入網站名稱，這個名稱可以根據項目的實際情況自定義，比如 “MyWebApiSite”。在 “物理路徑” 處，選擇剛才在 Visual Studio 中發布項目時指定的文件夾路徑，也就是我們存放發布文件的 “臨時倉庫” 位置。在 “綁定” 部分，設置網站的訪問地址和端口號。如果需要使用 HTTPS，還需要配置 SSL 證書。例如，設置訪問地址為 “http://localhost:8080”，端口號 8080 可以根據實際情況進行調整，只要不與服務器上其他已占用的端口沖突即可。

1. 配置應用程序池

   ：在 IIS 管理器中，找到剛才創建的網站對應的應用程序池。右鍵點擊應用程序池，選擇 “基本設置”。在 “.NET CLR 版本” 下拉菜單中，選擇 “無托管代碼”，因為.NET Core 應用不需要依賴傳統的.NET Framework 運行時，所以選擇 “無托管代碼” 模式。同時，將 “托管管道模式” 設置為 “集成”，這種模式能夠更好地支持.NET Core 應用在 IIS 中的運行。

1. 復制發布文件

   ：將在 Visual Studio 中生成的發布文件全部復制到 IIS 站點的物理路徑下。這一步就像是將貨物從 “臨時倉庫” 搬運到正式的 “銷售場所”，確保 IIS 能夠找到并運行這些文件。復制完成后，IIS 就可以根據配置的站點信息和應用程序池設置，啟動并運行我們的.NET Core WebApi 項目了。

完成以上步驟后，在瀏覽器中輸入配置的網站訪問地址（如http://localhost:8080），如果一切配置正確，就可以看到我們的.NET Core WebApi 項目已經成功部署并運行了。

七、總結與展望

通過以上內容，我們深入了解了.NET Core WebApi 開發的各個關鍵環節。從開篇引入，認識到前后端分離模式下后端開發的重要性，以及.NET Core WebApi 在其中的獨特優勢。我們詳細學習了.NET Core 的特性和 WebApi 在開發中的關鍵角色，親手搭建了開發環境并創建了第一個項目。在核心開發技術方面，深入剖析了控制器與路由、請求與響應處理以及數據訪問與持久化等關鍵技術，掌握了它們的工作原理和實際應用。同時，還分享了日志記錄、異常處理和緩存機制等實用開發技巧，這些技巧能夠大大提高項目的可維護性和性能。最后，我們完成了項目的部署發布，將開發成果呈現在服務器上，讓應用能夠為用戶提供服務。

對于讀者而言，希望你們能夠積極嘗試動手實踐，將所學知識運用到實際項目中。只有通過不斷地實踐，才能真正掌握這些技術，在遇到問題時不斷思考、探索，逐漸積累經驗，成為一名優秀的.NET Core WebApi 開發者。

展望未來，隨著技術的不斷發展，.NET Core 也將持續演進，其性能將不斷提升，功能將更加豐富。在未來的開發中，我們有望看到.NET Core WebApi 在更多領域得到廣泛應用，如人工智能、物聯網等。它將與其他新興技術深度融合，為開發者帶來更多的創新空間和機遇。讓我們一起期待.NET Core WebApi 在未來的精彩表現，不斷學習和探索，跟上技術發展的步伐，創造出更加優秀的應用程序。

閱讀原文：原文鏈接