WPF中如何在多窗口间共享HttpClient实例

嘿，作为WPF新手碰到这个问题太正常了！我来帮你一步步理清楚怎么处理HttpClient的单例共享～

首先，WPF里确实没有像ASP.NET MVC那样专门的Startup类，但App.xaml.cs就是整个应用的启动入口点，相当于MVC里的Startup，我们可以在这里做初始化工作。另外，还有几种简单的方式来实现HttpClient的单例共享，下面给你详细讲两种最常用的：

方式一：用静态类封装HttpClient（最适合新手快速上手） #

这种方式最简单直接，创建一个静态类来持有HttpClient的单例实例，所有窗口都直接调用这个静态类的实例即可。

步骤1：创建静态ApiClient类 #

using System.Net.Http;
using System.Text.Json;

public static class ApiClient
{
    // 静态只读的HttpClient实例，确保全局唯一
    private static readonly HttpClient _httpClient;

    // 静态构造函数，只执行一次，初始化HttpClient
    static ApiClient()
    {
        _httpClient = new HttpClient();
        // 这里配置你的API基础地址、超时时间等
        _httpClient.BaseAddress = new Uri("https://your-api-domain.com/");
        _httpClient.Timeout = TimeSpan.FromSeconds(30);
        // 如果需要默认请求头，也可以在这里添加
    }

    // 对外暴露实例的属性
    public static HttpClient Instance => _httpClient;
}

步骤2：在Login窗口中使用 #

public partial class Login : Window
{
    public Login()
    {
        InitializeComponent();
    }

    private async void LoginBtn_Click(object sender, RoutedEventArgs e)
    {
        // 构造登录请求数据
        var loginModel = new 
        { 
            Username = txtUsername.Text, 
            Password = txtPassword.Text 
        };
        var jsonContent = JsonSerializer.Serialize(loginModel);
        var requestContent = new StringContent(jsonContent, System.Text.Encoding.UTF8, "application/json");

        try
        {
            // 直接调用ApiClient的单例HttpClient
            var response = await ApiClient.Instance.PostAsync("api/auth/login", requestContent);
            response.EnsureSuccessStatusCode();

            // 登录成功后，把Token设置到HttpClient的默认请求头（后续接口自动携带）
            var token = await response.Content.ReadAsStringAsync();
            ApiClient.Instance.DefaultRequestHeaders.Authorization = 
                new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", token);

            // 打开主窗口并关闭登录窗口
            var mainWindow = new MainWindow();
            mainWindow.Show();
            this.Close();
        }
        catch (HttpRequestException ex)
        {
            MessageBox.Show($"登录失败：{ex.Message}");
        }
    }
}

步骤3：在MainWindow中使用 #

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
        // 窗口加载时获取用户信息
        LoadUserProfile();
    }

    private async void LoadUserProfile()
    {
        try
        {
            // 同样使用ApiClient的单例HttpClient
            var response = await ApiClient.Instance.GetAsync("api/user/profile");
            response.EnsureSuccessStatusCode();

            var userProfile = await response.Content.ReadFromJsonAsync<UserProfile>();
            // 绑定到UI控件
            lblUserName.Content = userProfile.Username;
            lblEmail.Content = userProfile.Email;
        }
        catch (HttpRequestException ex)
        {
            MessageBox.Show($"加载用户信息失败：{ex.Message}");
        }
    }
}

// 假设的用户Profile模型
public class UserProfile
{
    public string Username { get; set; }
    public string Email { get; set; }
}

方式二：利用App.xaml.cs存储HttpClient（更贴合WPF应用生命周期） #

WPF的App类是应用的全局实例，我们可以在App的启动事件里初始化HttpClient，然后通过Application.Current在各个窗口中获取。

步骤1：在App.xaml.cs中初始化HttpClient #

public partial class App : Application
{
    // 公开HttpClient属性
    public HttpClient AppHttpClient { get; private set; }

    protected override void OnStartup(StartupEventArgs e)
    {
        base.OnStartup(e);
        // 初始化HttpClient
        AppHttpClient = new HttpClient();
        AppHttpClient.BaseAddress = new Uri("https://your-api-domain.com/");
        AppHttpClient.Timeout = TimeSpan.FromSeconds(30);
    }
}

步骤2：在窗口中获取并使用 #

比如在Login窗口里：

private async void LoginBtn_Click(object sender, RoutedEventArgs e)
{
    // 获取App实例中的HttpClient
    var httpClient = ((App)Application.Current).AppHttpClient;
    // 后续请求逻辑和方式一完全一致...
}

进阶推荐：使用依赖注入（适合中大型项目） #

如果你的项目后续会扩展，推荐用依赖注入（DI）来管理HttpClient，这样代码更解耦，也方便单元测试。WPF可以结合Microsoft.Extensions.DependencyInjection来实现：

步骤1：配置DI容器（在App.xaml.cs中） #

using Microsoft.Extensions.DependencyInjection;

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
        base.OnStartup(e);

        var services = new ServiceCollection();
        
        // 注册HttpClient为单例
        services.AddSingleton<HttpClient>(sp =>
        {
            var client = new HttpClient();
            client.BaseAddress = new Uri("https://your-api-domain.com/");
            client.Timeout = TimeSpan.FromSeconds(30);
            return client;
        });

        // 注册你的窗口（Transient表示每次获取都是新实例）
        services.AddTransient<Login>();
        services.AddTransient<MainWindow>();

        // 构建服务提供者
        var serviceProvider = services.BuildServiceProvider();

        // 从DI容器中获取Login窗口并显示
        var loginWindow = serviceProvider.GetRequiredService<Login>();
        loginWindow.Show();
    }
}

步骤2：构造函数注入HttpClient到窗口 #

public partial class Login : Window
{
    private readonly HttpClient _httpClient;

    // 构造函数注入HttpClient
    public Login(HttpClient httpClient)
    {
        InitializeComponent();
        _httpClient = httpClient;
    }

    // 登录事件中直接使用_httpClient即可...
}

重要提醒：为什么要单例使用HttpClient？ #

HttpClient的底层会创建套接字连接，如果频繁创建和销毁HttpClient实例，会导致套接字资源耗尽，引发性能问题甚至报错。所以全局单例复用是官方推荐的最佳实践哦～

内容的提问来源于stack exchange，提问作者geostocker