无法将.NET MAUI测试应用与ASP.NET Web API连接，求排查方案

核心原因分析 #

• localhost指向错误：MAUI在模拟器/真机运行时，localhost指代设备自身而非运行Web API的开发电脑，导致无法访问电脑上的服务。
• CORS配置存在问题：即便添加了CORS配置，可能存在允许源范围错误、HTTP方法未授权，或者中间件顺序错误（比如CORS配置放在路由之后）。
• SSL证书不被信任：开发环境的Web API多使用自签名SSL证书，模拟器/真机默认不信任这类证书，会拦截HTTPS请求。
• 网络权限缺失：Android和iOS平台需要明确授予网络访问权限，否则应用无法发起网络请求。

针对性解决办法 #

1. 修正API请求地址 #

根据运行环境替换localhost：

• Android模拟器：使用10.0.2.2（模拟器映射主机localhost的专用IP）
• iOS模拟器：可直接用localhost
• 真机测试：使用开发电脑的局域网IP（如192.168.1.100），同时确保Web API绑定到0.0.0.0或局域网IP，防火墙放行对应端口。

示例修正代码：

// Android模拟器场景
var response = await App.HttpClient.GetAsync($"https://10.0.2.2:7183/api/Patients/Test");
// 真机场景（替换为你的电脑局域网IP）
var response = await App.HttpClient.GetAsync($"https://192.168.1.100:7183/api/Patients/Test");

2. 确保CORS配置正确 #

在ASP.NET Web API的Program.cs中，将CORS中间件放在路由和授权之前，配置需涵盖正确的源、方法和头部：

var builder = WebApplication.CreateBuilder(args);

// 配置CORS策略（开发环境临时允许所有源，生产环境需指定具体域名）
builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowAll", policy =>
    {
        policy.AllowAnyOrigin()
              .AllowAnyMethod()
              .AllowAnyHeader();
    });
});

builder.Services.AddControllers();

var app = builder.Build();

// 必须在UseRouting之后、UseAuthorization之前启用CORS
app.UseCors("AllowAll");

app.UseRouting();
app.UseAuthorization();
app.MapControllers();

app.Run();

3. 处理SSL证书信任问题 #

• Android：在Platforms/Android/AndroidManifest.xml中添加配置，允许明文HTTP请求（仅开发环境使用）：

  <application android:usesCleartextTraffic="true"></application>
  

• iOS：在Platforms/iOS/Info.plist中添加网络安全例外，允许指定IP的HTTP请求：

  <key>NSAppTransportSecurity</key>
  <dict>
      <key>NSExceptionDomains</key>
      <dict>
          <key>192.168.1.100</key> <!-- 替换为你的API IP/域名 -->
          <dict>
              <key>NSIncludesSubdomains</key>
              <true/>
              <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
              <true/>
          </dict>
      </dict>
  </dict>
  

  也可将自签名证书导入模拟器/真机的信任列表（更安全）。

4. 添加MAUI网络权限 #

• Android：在Platforms/Android/AndroidManifest.xml中添加权限：

  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  

• iOS：默认允许网络访问，若有特殊配置需检查Info.plist是否存在网络限制项。

额外排查步骤 #

• 用设备浏览器访问API地址，确认服务可正常访问。
• 检查开发电脑防火墙，放行Web API的端口（7183）。
• 捕获更详细的异常信息，查看内部错误提示：

  catch (Exception ex)
  {
      var errorMsg = ex.Message;
      if (ex.InnerException != null)
          errorMsg += $"\n内部错误：{ex.InnerException.Message}";
      await DisplayAlert("Błąd", $"Wystąpił problem: {errorMsg}", "OK");
  }
  

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