萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 模擬器訪問本機 Tomcat/IIS 服務:特殊 IP 10.0.2.2 解決 localhost 無法連接

核心結論

Android 模擬器內部將 **10.0.2.2** 映射到 **宿主機 (開發電腦) 的 127.0.0.1 (localhost)**。因此,模擬器中訪問本機服務器只需將 URL 中的 localhost 或 127.0.0.1 替換為 10.0.2.2。

常見服務器配置示例

服務器默認端口模擬器訪問 URL
Tomcat8080https://10.0.2.2:8080/your-app/api
IIS / IIS Express80 / 443 / 隨機https://10.0.2.2:/api
Node.js / Spring Boot / Python Flask3000 / 8080 / 5000https://10.0.2.2:/api
Docker 容器 (宿主機網絡模式)同上https://10.0.2.2:/api

服務器端綁定配置 (關鍵)

**必須綁定 0.0.0.0 (所有介面),而非 127.0.0.1**,否則模擬器無法連接。

# Tomcat server.xml
<Connector port="8080" protocol="HTTP/1.1" 
           address="0.0.0.0" 
           connectionTimeout="20000" redirectPort="8443" />

# Spring Boot application.yml
server:
  address: 0.0.0.0
  port: 8080

# Node.js Express
app.listen(3000, '0.0.0.0', () => console.log('Server running'));

# Python Flask
app.run(host='0.0.0.0', port=5000)

# IIS: 默認綁定所有 IP,無需額外配置
# IIS Express: 修改 .vs/config/applicationhost.config
#     (而非 127.0.0.1)
#   需以管理員運行 VS 或預留 URL: netsh http add urlacl url=https://*:port/ user=Everyone

防火牆/安全軟件放行

  • Windows 防火牆:入站規則允許對應端口 (TCP)
  • 360/火綿/Windows Defender:信任該端口/進程
  • 公司網絡策略可能阻擋,嘗試熱點/移動網絡驗證

Android 9+ (API 28) 明文流量限制

HTTP 服務需在 AndroidManifest.xml <application> 添加:

android:usesCleartextTraffic="true"

或配置 res/xml/network_security_config.xml:

<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">10.0.2.2</domain>
        <domain includeSubdomains="true">192.168.x.x</domain> <!-- 局域網真機調試 -->
    </domain-config>
</network-security-config>

Manifest 應用:android:networkSecurityConfig="@xml/network_security_config"

真機調試 (非模擬器) 訪問本機服務

  • 同一 Wi-Fi/LAN:電腦 IP (如 192.168.1.100) + 端口
  • USB 端口轉發:adb reverse tcp:8080 tcp:8080 → 手機訪問 https://localhost:8080
  • ADB over Wi-Fi (Android 11+):adb pair ip:port + adb connect ip:port

模擬器網絡架構速覽

模擬器內部 IP: 10.0.2.15 (dhcp 分配)
網關/DNS:       10.0.2.2  ← 映射到宿主機 localhost
DNS 服務器:     10.0.2.3
模擬器間通信:   10.0.2.4, 10.0.2.5 ...
宿主機回環:     127.0.0.1 (模擬器自身,非宿主機)

驗證連通性

# 模擬器終端 (adb shell)
ping 10.0.2.2
curl -v https://10.0.2.2:8080/health

# 宿主機終端
netstat -an | findstr :8080  # 確認服務監聽 0.0.0.0:8080

總結

Android 模擬器訪問宿主機服務的「金鑰」是 **10.0.2.2**。配合服務器綁定 0.0.0.0、防火牆放行、Android 9+ 明文流量配置、USB reverse 真機調試,可構建順暢的本地全鏈路開發調試環境。牢記此 IP,告別「localhost 連不上」的困擾。

copyright © 萬盛學電腦網 all rights reserved