Maui应用访问Localhost时连接失败问题排查求助

问题背景 #

• 生产环境ASP.NET Web服务调用完全正常
• Postman访问本地IIS地址http://localhost:portnum/myurl?param1=x&param2=y可正常触发服务断点
• Maui应用中执行相同PostAsync调用时，初始报连接错误；修改网络安全配置后变为连接错误（任务已取消），始终无法触发IIS断点
• 已尝试：替换localhost为电脑局域网IP（10.0.1.151）、配置Android网络安全允许明文流量、开放防火墙内部端口，模拟器/物理设备均无效，切换HTTPS协议问题依旧

排查与解决步骤 #

1. 确认本地IIS站点的IP绑定 #

打开IIS管理器，找到目标站点：

• 右键→编辑绑定
• 检查绑定的IP地址是否为*（允许所有IP访问），或明确包含你的电脑局域网IP（10.0.1.151）
• 如果绑定的是localhost或127.0.0.1，局域网内的模拟器/物理设备根本无法访问，必须修改为允许外部IP的绑定规则

2. 验证端口的监听状态 #

用命令行执行以下命令，检查端口是否对外开放：

netstat -ano | findstr :你的端口号

• 确认结果中存在0.0.0.0:端口号（表示监听所有IP），且对应的进程ID是IIS的w3wp.exe
• 换一台局域网内的电脑，用浏览器访问http://10.0.1.151:portnum/myurl?param1=x&param2=y，如果无法访问，说明问题出在IIS本身的对外配置，与Maui无关

3. 检查Maui请求代码的潜在问题 #

避免同步等待导致死锁

如果在UI线程直接用.Result或.Wait()等待异步请求，会触发任务取消：
错误示例：

var response = httpClient.PostAsync(requestUrl, content).Result;

正确写法（在异步方法中使用）：

var response = await httpClient.PostAsync(requestUrl, content).ConfigureAwait(false);

检查超时设置

确认HttpClient的超时时间是否过短，默认是100秒，但如果代码中手动修改过，会直接触发超时：

httpClient.Timeout = TimeSpan.FromSeconds(30); // 确保时间足够

验证请求内容与头信息

检查请求的Content-Type是否与服务端要求一致，是否遗漏必要的请求头（比如Authorization、Accept等），Postman中能正常请求的头信息要完全同步到Maui代码中

4. Android模拟器的特殊网络适配 #

不同Android模拟器访问宿主电脑的地址不同：

• Android Studio模拟器：用10.0.2.2代替宿主的localhost
• 微软Android模拟器：用169.254.80.80或宿主的局域网IP
• 确保你的network_security_config.xml中包含对应地址，比如添加10.0.2.2

5. HTTPS自签名证书处理（若使用HTTPS） #

本地IIS的HTTPS证书是自签名的，Maui默认不信任，会导致连接失败：
仅测试环境可临时忽略证书验证（生产环境禁止）：

var handler = new HttpClientHandler();
handler.ServerCertificateCustomValidationCallback = (sender, cert, chain, sslPolicyErrors) => true;
var httpClient = new HttpClient(handler);

正式测试可将自签名证书安装到Android设备的信任列表中

6. 防火墙规则的深层检查 #

• 打开Windows Defender防火墙→高级设置→入站规则
• 找到你添加的端口规则，检查高级选项卡中的配置文件是否勾选了所有网络类型（域、专用、公网）
• 临时关闭防火墙测试，若能连接，说明是防火墙规则的配置问题

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