Android模拟器无法访问本地REST API的故障排查求助

你已经完成了Android侧所有常规配置，故障点全部在本地服务侧，按以下顺序操作即可解决：

• 修正ASP.NET服务监听绑定
  Visual Studio默认启动的ASP.NET项目（尤其是用IIS Express托管时）只会绑定localhost环回地址，模拟器属于独立虚拟网络设备，不在本机环回范围内，哪怕配了10.0.2.2转发也无法访问。
  操作步骤：
  1. 打开项目下Properties/launchSettings.json文件，找到所有配置项的applicationUrl字段，把其中的localhost全部替换为0.0.0.0，例如原配置https://localhost:7045;http://localhost:5045修改为https://0.0.0.0:7045;http://0.0.0.0:5045
  2. 启动项目时不要选择IIS Express配置，直接选择项目同名的Kestrel自托管启动项，IIS Express默认拦截外部连接，改配置成本极高，自托管是调试阶段的最优选择。
• 放行防火墙端口规则
  Windows默认会拦截所有非本机发起的入站连接，需要手动给API端口开白名单：
  1. 打开Windows Defender防火墙高级设置，新建入站规则，规则类型选择「端口」，协议选TCP，填入你API使用的HTTP、HTTPS端口号
  2. 选择「允许连接」，勾选域、专用、公用所有网络类型，保存规则即可
  3. 校验：启动API后，用同局域网下其他设备（比如连同一WiFi的实体手机）访问http://你的本机局域网IP:API的HTTP端口/默认测试接口，能正常返回结果说明绑定和防火墙配置都正确，本机局域网IP可通过在命令行执行ipconfig查看当前联网网卡的IPv4地址获取。
• 规避HTTPS证书拦截问题
  调试阶段直接用HTTP端口发起请求即可：Android系统默认不信任ASP.NET Core生成的本地开发HTTPS证书，会直接断开HTTPS连接，不需要额外折腾证书导入，等联调通了再处理HTTPS问题即可。
• 补全Android侧漏配项
  如果你用的是Android 11及以上版本的模拟器，需要在AndroidManifest.xml的<application>标签下添加android:usesCleartextTraffic="true"属性，否则系统默认禁止所有HTTP明文请求，哪怕网络连通也会被拦截。之前修改过的模拟器DNS、代理配置全部重置为默认，冷启动模拟器后再测试。

验证路径：启动修改完配置的API项目 → 本机浏览器访问http://127.0.0.1:你的HTTP端口确认服务正常 → 同局域网设备访问http://你的本机局域网IP:你的HTTP端口确认外部可访问 → 模拟器内置浏览器访问http://10.0.2.2:你的HTTP端口，即可正常连通。

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