.NET MAUI安卓端发起基础Web请求报平台不支持异常解决方法

你抛出的Operation is not supported on this platform异常和权限、网络拦截配置无关，核心原因是**.NET MAUI 移动端平台下的默认HttpClient不支持同步的Send()方法**。
MAUI在Android、iOS平台默认调用原生平台网络栈实现Http请求处理，原生侧仅提供异步网络请求API，没有对应的同步阻塞实现，因此直接调用同步Send()会直接抛出平台不支持异常。

1. 替换同步请求为异步实现 #

把同步的Send调用改成SendAsync，全程使用async/await异步写法，不要用.Result、.Wait()这类阻塞式调用，否则会触发线程死锁。
修改后的参考代码：
建议将HttpClient设为单例生命周期，避免频繁创建实例导致端口耗尽：

// 单例复用HttpClient实例
private static readonly HttpClient client = new HttpClient();
private void init_network()
{
    client.DefaultRequestHeaders.Accept.Add(new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));
}

调整请求方法为异步签名：

private async Task<bool> SendCommand(string command)
{ 
    try
    {
        var msg = new HttpRequestMessage(HttpMethod.Post, url);
        msg.Content = JsonContent.Create(command);
        // 替换同步Send为异步SendAsync
        HttpResponseMessage response = await client.SendAsync(msg);

        if (response.IsSuccessStatusCode)
        {
            return true;
        }
    }
    catch (Exception err)
    {
        Console.WriteLine(err.Message);
    }
    return false;
}

对应的按钮点击事件需要声明为async void适配异步调用：

private async void OnCommandSendClicked(object sender, EventArgs e)
{
    bool sendResult = await SendCommand("目标指令内容");
    // 自行处理请求结果逻辑
}

如果存量同步代码改造难度大，也可以临时切换到托管实现的SocketsHttpHandler替代默认原生Handler，该实现支持同步Send方法，但会丢失原生网络栈的性能优化、增大应用包体积，不推荐作为长期方案：

// 在MauiProgram.cs的builder配置中添加
builder.Services.AddHttpClient()
    .ConfigurePrimaryHttpMessageHandler(() => new SocketsHttpHandler());

2. 处理ESP32本地服务的证书/明文请求限制 #

你访问的是局域网固定IP192.168.4.1的服务，ESP32部署的HTTPS服务默认使用自签名证书，改完异步请求后大概率会遇到证书校验失败问题，开发调试阶段可以临时配置回调绕过校验（正式上线前必须移除该逻辑，存在安全风险）：

// 仅DEBUG生效
#if DEBUG
builder.Services.AddHttpClient("LocalEspClient")
    .ConfigurePrimaryHttpMessageHandler(() => new HttpClientHandler
    {
        ServerCertificateCustomValidationCallback = (_, _, _, _) => true
    });
#endif

如果要使用HTTP明文协议请求，还需要额外配置Android网络安全规则：

1. 在Platforms/Android/Resources/xml路径下新建network_security_config.xml文件：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
  <domain-config cleartextTrafficPermitted="true">
    <domain includeSubdomains="true">192.168.4.1</domain>
  </domain-config>
</network-security-config>

2. 在AndroidManifest.xml的<application>标签中添加属性android:networkSecurityConfig="@xml/network_security_config"，放行对该本地IP的明文请求。

3. 权限校验 #

你现有清单文件中已经配置了INTERNET、ACCESS_NETWORK_STATE权限，满足网络请求要求，ACCESS_FINE_LOCATION是之前BLE功能所需权限，网络请求本身不需要该权限，无需额外新增其他权限配置。

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