Avalonia中调用Web API需使用HttpClient（推荐单例或IHttpClientFactory注入），在ViewModel中异步发起GET/POST请求，检查响应状态并安全更新INotifyPropertyChanged属性以触发UI刷新，避免阻塞主线程。
在 Avalonia 中调用 Web API（如 RESTful 接口）和标准 .NET 应用一样，主要依靠 HttpClient，没有框架层面的特殊封装。关键在于正确管理生命周期、避免 UI 线程阻塞、处理异步结果并安全更新界面。
使用 HttpClient 发起 GET/POST 请求
Avalonia 是跨平台 UI 框架，不内置 HTTP 客户端，所以直接使用 .NET 的 HttpClient（推荐注入为单例或使用 IHttpClientFactory）。例如在 ViewModel 中发起请求：
- 定义一个可注入的 service（如
IApiService），内部封装HttpClient调用逻辑 - GET 示例：
var response = await _httpClient.GetAsync("https://api.example.com/users"); - POST 示例（JSON）：
var content = new StringContent(JsonSerializer.Serialize(user), Encoding.UTF8, "application/json"); var response = await _httpClient.PostAsync("https://api.example.com/users", content); - 记得检查
response.IsSuccessStatusCode，再读取await response.Content.ReadAsStringAsync()
在 ViewModel 中安全处理异步结果
Avalonia 的绑定系统支持异步属性，但 UI 更新必须在主线程执行。推荐方式是：用 await 获取数据后，在 ViewModel 中更新 INotifyPropertyChanged 属性（如 public ObservableCollection），Avalonia 会自动刷新视图。
- 不要在命令执行中直接
Task.Wait()或.Result—— 会导致 UI 冻结 - 命令应声明为
ICommand（如ReactiveCommand或RelayCommand），支持 async/await - 加载状态可用布尔属性（如
IsLoading）配合NotifyPropertyChanged控制按钮禁用或显示 Spinner
处理认证与跨域（开发阶段常见问题）
如果 Web API 需要 Token 或 Cookie 认证，可在 HttpClient 中统一设置：
- Bearer Token：
_httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token); - 自定义 Header（如 API Key）：
_httpClient.DefaultRequestHeaders.Add("X-Api-Key", "your-key"); - 本地开发时若遇到 CORS 报错，不是 Avalonia 问题，而是浏览器或服务端限制 —— 确保后端已配置允许你的前端地址（如
http://localhost:5000） - Avalonia 桌面应用本身无同源策略，CORS 只影响内嵌 WebView 场景；纯 HTTP 调用不受限
错误处理与用户体验优化
网络请求失败很常见，需明确提示用户而非静默失败：
- 捕获
HttpRequestException（网络异常）、JsonException（解析失败）、HTTP 状态码（如 401/404/500） - 将错误信息转为用户友好的提示（如 “登录已过期，请重新登录”），通过属性绑定到 TextBlock 或 Dialog 显示
- 考虑添加重试逻辑（如 Polly 库），尤其对临时性网络抖动
- 避免重复提交：命令执行中设
IsLoading = true并禁用按钮，完成后恢复
不复杂但容易忽略的是生命周期管理 —— 不要在每次请求都 new HttpClient，也不要在 View 中直接写网络代码。把 HTTP 逻辑收进 service，ViewModel 负责协调状态，View 只管展示，这样既可测试又易维护。
