WPF MVVM模式下从API获取数据绑定TreeView及反序列化问题排查

首先明确：接口返回的JSON/XML格式内容必须做反序列化才能转换为C#可直接操作的强类型对象，这一步没有跳过的可能。你现有代码存在以下明确问题：

• async void 被错误用在了非事件处理方法上：该写法会导致调用方无法等待异步执行完成、异常无法被上层正常捕获，极易出现静默崩溃、线程死锁问题，正确返回值应为Task<T>。
• HttpClient 用法错误：每次请求都新建HttpClient实例会导致套接字资源耗尽，正确做法是使用全局静态单例或IHttpClientFactory统一管理生命周期。
• 反序列化逻辑兼容性差：ReadAsAsync<T>是旧版WebApi客户端包的扩展方法，在新版.NET WPF项目中默认不内置，且默认序列化配置极易和接口的驼峰/帕斯卡命名规则不匹配，是你反序列化报错的核心诱因。另外EnsureSuccessStatusCode()本身就会在请求失败时抛出异常，后续的IsSuccessStatusCode判断属于冗余代码。
• MVVM分层违规：EmployeeService属于纯数据处理层，不应该直接耦合MessageBox这类UI交互逻辑，UI提示应该交给上层ViewModel处理。
• 数据流转逻辑无效：你写的GetAll方法仅把传入的列表直接返回，没有将拉取到的数据暴露给ViewModel，根本无法实现UI绑定。
• 没有针对TreeView做树形结构处理：TreeView需要层级化的数据源，如果你接口返回的是带父ID的平级员工列表，直接绑定无法显示层级结构。

1. 修正Model层定义 #

首先保证EmployeeModel的属性和接口返回字段匹配，同时添加TreeView需要的子节点集合属性：

public class EmployeeModel
{
    // 属性名和接口返回JSON字段保持一致即可，可根据实际接口字段调整
    public int Id { get; set; }
    public string EmployeeName { get; set; }
    public string Post { get; set; }
    public int? ParentDeptId { get; set; } // 树形结构父级ID，平级列表转层级用
    public List<EmployeeModel> Children { get; set; } = new List<EmployeeModel>();
}

然后重写EmployeeService逻辑，移除UI耦合、修正异步写法、替换稳定的反序列化方案：

public class EmployeeService
{
    // 全局静态HttpClient实例，避免套接字耗尽
    private static readonly HttpClient _httpClient = new HttpClient()
    {
        BaseAddress = new Uri("替换为你的API根地址")
    };

    public async Task<List<EmployeeModel>> GetAllEmployeeAsync()
    {
        try
        {
            // 直接拉取接口返回的JSON字符串
            string jsonContent = await _httpClient.GetStringAsync("GetEmployee");
            // 反序列化，.NET Core 3.0+用内置System.Text.Json即可，.NET Framework可替换为Newtonsoft.Json
            List<EmployeeModel> flatEmployees = JsonSerializer.Deserialize<List<EmployeeModel>>(jsonContent, new JsonSerializerOptions
            {
                PropertyNameCaseInsensitive = true // 忽略属性名大小写匹配，解决命名规则不一致导致的反序列化失败
            });

            // 如果接口本身返回嵌套层级结构，直接return flatEmployees即可，不需要执行下面的树形构造
            return BuildTreeStructure(flatEmployees);
        }
        catch (HttpRequestException)
        {
            throw new Exception("API请求失败，请检查后端服务是否正常启动");
        }
        catch (JsonException)
        {
            throw new Exception("返回数据格式解析失败，请核对接口字段和实体类定义是否匹配");
        }
    }

    // 平级列表转TreeView可用的层级结构
    private List<EmployeeModel> BuildTreeStructure(List<EmployeeModel> flatList)
    {
        List<EmployeeModel> treeRoot = new List<EmployeeModel>();
        foreach (var item in flatList)
        {
            if (item.ParentDeptId == null)
            {
                treeRoot.Add(item);
                continue;
            }
            var parent = flatList.FirstOrDefault(e => e.Id == item.ParentDeptId);
            parent?.Children.Add(item);
        }
        return treeRoot;
    }
}

2. 实现ViewModel层 #

ViewModel需要实现INotifyPropertyChanged接口，暴露UI绑定用的集合属性和加载命令，UI提示逻辑放在这一层处理：

public class EmployeeViewModel : INotifyPropertyChanged
{
    private readonly EmployeeService _employeeService = new EmployeeService();
    private List<EmployeeModel> _employeeTreeData;

    // TreeView绑定的数据源
    public List<EmployeeModel> EmployeeTreeData
    {
        get => _employeeTreeData;
        set
        {
            _employeeTreeData = value;
            OnPropertyChanged();
        }
    }

    // 绑定到加载按钮的命令
    public ICommand LoadEmployeeCmd { get; }

    public EmployeeViewModel()
    {
        LoadEmployeeCmd = new RelayCommand(async () => await LoadDataAsync());
    }

    private async Task LoadDataAsync()
    {
        try
        {
            EmployeeTreeData = await _employeeService.GetAllEmployeeAsync();
        }
        catch (Exception ex)
        {
            MessageBox.Show(ex.Message);
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;
    protected void OnPropertyChanged([CallerMemberName] string propName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propName));
    }
}

// 轻量ICommand实现，如果你用Prism、MVVM Toolkit等框架，直接用框架自带的实现即可
public class RelayCommand : ICommand
{
    private readonly Func<Task> _execute;
    private readonly Func<bool> _canExecute;

    public RelayCommand(Func<Task> execute, Func<bool> canExecute = null)
    {
        _execute = execute;
        _canExecute = canExecute;
    }

    public bool CanExecute(object parameter) => _canExecute == null || _canExecute();
    public async void Execute(object parameter) => await _execute();
    public event EventHandler CanExecuteChanged;
    public void RaiseCanExecute() => CanExecuteChanged?.Invoke(this, EventArgs.Empty);
}

3. XAML端绑定TreeView #

给窗口设置DataContext，用HierarchicalDataTemplate配置TreeView的层级模板：

<Window x:Class="YourAppName.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:YourAppName"
        Title="员工管理" Height="500" Width="900">
    <Window.DataContext>
        <local:EmployeeViewModel/>
    </Window.DataContext>
    <Grid Margin="10">
        <Button Content="加载员工列表" Command="{Binding LoadEmployeeCmd}" Height="32" VerticalAlignment="Top"/>
        <TreeView ItemsSource="{Binding EmployeeTreeData}" Margin="0 50 0 0">
            <TreeView.ItemTemplate>
                <HierarchicalDataTemplate ItemsSource="{Binding Children}">
                    <StackPanel Orientation="Horizontal">
                        <TextBlock Text="{Binding EmployeeName}" Margin="0 0 10 0"/>
                        <TextBlock Text="{Binding Post}" Foreground="Gray"/>
                    </StackPanel>
                </HierarchicalDataTemplate>
            </TreeView.ItemTemplate>
        </TreeView>
    </Grid>
</Window>

如果反序列化仍然报错，直接加断点查看GetStringAsync拿到的原始JSON字符串，核对字段名、数据类型和EmployeeModel是否匹配，90%的反序列化错误都是字段不匹配导致的。生产环境建议使用IHttpClientFactory管理HttpClient实例，比静态单例的故障恢复能力更强。

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