Android模拟器无法连接localhost访问本地ASP Web应用怎么办

按优先级从高到低排查，覆盖90%以上同类场景问题：

一、基础地址匹配校验 #

• 首先确认你用的模拟器类型，不要混用映射地址：
  • 谷歌官方Android Emulator：宿主机回环地址映射为10.0.2.2
  • Genymotion、国内第三方模拟器（雷电、夜神、逍遥等）：宿主机回环地址映射为10.0.3.2
• 如果要直接连宿主机局域网IP，先确认宿主机和模拟器在同一网段，且宿主机没有开VPN、虚拟网卡抢占网段的情况。
• 如果之前手动设置过模拟器代理，先清空代理配置，或把上述本地映射地址加入代理绕过列表，避免请求被错误转发到代理服务器。

二、ASP应用监听配置排查（最高发问题） #

绝大多数连接失败都是因为应用默认只监听本地回环地址，模拟器作为外部设备根本无法接入：

• 用IIS Express调试的场景：找到项目目录下.vs/config/applicationhost.config文件，定位到你当前项目的站点<bindings>节点，新增一条绑定规则：

<binding protocol="http" bindingInformation="*:你的应用运行端口:*" />

修改完成后必须以管理员身份重启IIS Express，普通权限启动不会加载新的绑定规则。

• 用IIS正式部署的场景：打开IIS管理器找到对应站点，右键选「编辑绑定」，把对应端口的绑定IP从127.0.0.1改为「全部未分配」，同时确认应用池启动正常、站点权限配置无误。
• 用ASP.NET Core + Kestrel调试的场景：打开项目下Properties/launchSettings.json，找到对应启动配置的applicationUrl字段，把默认的http://localhost:端口改为http://0.0.0.0:端口，保证Kestrel监听所有网卡的请求。
• 配置完成后可以在宿主机开命令提示符，执行netstat -ano | findstr "你的应用端口"验证，如果返回结果中监听地址是0.0.0.0:端口说明配置生效，如果是127.0.0.1:端口说明仍然只监听回环，需要重新检查配置。

三、防火墙与连通性排查 #

• 临时关闭宿主机的Windows Defender防火墙、第三方安全软件的网络防护，再尝试连接，如果关闭后能正常访问，说明是端口被拦截，给对应应用端口添加入站放行规则即可，不建议长期关闭防火墙。
• 验证连通性的时候先用模拟器自带的浏览器访问地址，不要直接在自己开发的App里测试，先排除App本身的配置问题。
• 如果浏览器也访问不了，通过adb shell进入模拟器终端，ping对应的映射地址/宿主机局域网IP，如果ping不通，选择模拟器冷启动（不要用快照快速启动），或者重置模拟器的网络配置后重试。

四、Android端系统限制排查 #

• 检查App是否声明网络权限：在AndroidManifest.xml中确认存在<uses-permission android:name="android.permission.INTERNET" />权限声明，没有该权限所有网络请求都会被直接拦截。
• Android 9（API 28）及以上版本默认禁止明文HTTP请求，如果你的本地ASP没有配置HTTPS，会被系统直接拦截。可以通过配置网络安全规则放开本地地址的明文访问限制：
  1. 在项目res/xml目录下新建network_security_config.xml文件：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">10.0.2.2</domain>
        <domain includeSubdomains="true">10.0.3.2</domain>
        <domain includeSubdomains="true">你的宿主机局域网IP</domain>
    </domain-config>
</network-security-config>

2. 在AndroidManifest.xml的<application>标签中添加属性：android:networkSecurityConfig="@xml/network_security_config"

快速验证流程 #

按以下顺序测试可以快速定位问题节点，不用盲目改配置：

1. 宿主机本地浏览器访问http://127.0.0.1:端口，确认应用本身正常运行
2. 宿主机本地浏览器访问http://宿主机局域网IP:端口，确认应用已经监听非回环地址
3. 关闭宿主机防火墙，用模拟器自带浏览器访问对应映射地址+端口，确认网络链路通
4. 以上三步都通过后，再在自己的App里发请求，排查App端代码、配置问题

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