1. 真机无线测试为什么总卡在“连不上”这一步真机无线测试这件事听起来只是把 APK 装到手机上点一下登录但真正做过 Android APK 局域网调试的人都知道十次失败里有八次不是代码写错了而是手机和电脑根本没在一条能互通的链路上。你打开 Android Studio 打包出 APK装到手机上输入账号密码结果弹出一句Failed to connect to /10.27.239.87:8080这时候很多人第一反应是去翻后端日志其实后端可能压根没收到请求。我先把这篇要解决的问题说清楚你要在本地跑一个后端服务把 Android APK 装到真机上让手机通过局域网访问电脑上的服务完成登录或接口联调同时把调试请求统一走 TaoToken 的 Key/API 通道转发避免每个项目到处散落不同的 Key 和 Base URL。适合谁看适合正在做移动端真机联调、被校园网隔离或热点地址搞晕、想让调试链路更可控的 Android 开发和测试同学。核心检索词先摆出来真机无线测试、Android APK、局域网、ipconfig、端口。这五个词基本覆盖了整条链路的每个环节。真机无线测试的本质是“手机和电脑在同一网段 正确 IP 正确端口 服务正在运行”缺一个都不行。而 TaoToken 在这里的角色是帮你把调试请求的出口统一成一个可管理的通道Base URL 和 Key 集中配置换项目、换模型、换环境时不用满仓库改地址。下面我会按真实操作顺序走一遍先定位本机局域网 IP确认端口占用再配 TaoToken 的 Base URL 和 Key然后验证端口连通性最后用真机抓包确认请求到底命中了哪里。每一步都给可复制的命令和配置片段你照着做就能复现。2. 用 ipconfig 定位局域网 IP 并确认端口占用2.1 ipconfig 到底给你什么不给你什么很多人第一次做真机无线测试会误以为ipconfig能查到端口这是个典型误区。ipconfig只负责告诉你本机网卡当前分配到的 IPv4 地址端口来自后端服务的启动参数或配置文件两者是分开的。连接地址永远是http://IPv4:port这个组合IP 靠 ipconfigport 靠后端确认。在 Windows 上打开 CMD 或 PowerShell执行ipconfig你会看到多个网卡段落重点找你当前实际联网的那块。如果你用的是手机热点通常看“无线局域网适配器 WLAN”或“无线局域网适配器 本地连接*”下面的 IPv4 地址常见的是172.20.10.x这种网段。如果你连的是家里路由器可能是192.168.1.x或192.168.0.x。校园网环境下经常是10.x.x.x而这种网段往往带客户端隔离手机和电脑虽然都“联网”了但互相 ping 不通。我实测下来最稳的做法是手机开热点电脑连这个热点然后在电脑上执行 ipconfig拿到热点网段下的 IPv4。这样手机和电脑天然在同一网段不存在隔离策略。拿到地址后先记下来比如172.20.10.13。2.2 确认端口占用别让服务起在错误端口端口这块后端启动时一定要监听0.0.0.0而不是127.0.0.1。127.0.0.1只允许本机访问手机通过局域网是打不进来的。以常见的 Python 服务为例uvicorn main:app --host 0.0.0.0 --port 8080或者python main.py但python main.py是否监听0.0.0.0取决于代码里的配置你要去确认。启动前先查端口有没有被占用Windows 下netstat -ano | findstr :8080如果输出里有LISTENING说明端口已被占用要么换端口要么把占用进程结束掉。Linux/macOS 下lsof -i :8080确认端口空闲后再启动服务。启动成功后本机先自测一下curl http://127.0.0.1:8080/health本机通不代表局域网通这一步只是排除服务本身没起来的问题。真正的局域网连通性验证放到第 4 节。2.3 把调试请求统一到 TaoToken 通道到这里你有了 IP 和端口但每个项目的调试请求如果各自配 Base URL 和 Key管理起来很乱。TaoToken 的作用是把这些请求统一到一个 API 通道上。你需要在 TaoToken 控制台创建一个 API Key然后拿到统一的 Base URL。配置时记住三件套Base URL、Key、Model ID。Base URL 用https://taotoken.net/apiKey 用你在控制台生成的Model ID 按你实际调用的模型填。这三样在后面的 JSON 配置里会完整出现。3. 可复制的 Base URL 与 Key 配置片段3.1 后端服务的环境变量配置先在后端项目根目录建一个.env文件把 TaoToken 的通道配置写进去。这样后端转发调试请求时统一读这里不用硬编码# .env TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_API_KEYsk-你的实际Key TAOTOKEN_MODEL_ID你的模型ID BACKEND_HOST0.0.0.0 BACKEND_PORT8080注意BACKEND_HOST必须是0.0.0.0这是手机能访问进来的前提。BACKEND_PORT和你后面 Android 端配置的端口必须一致。3.2 Android 端的 Base URL 配置Android 项目里接口基地址通常放在BuildConfig或gradle.properties里。推荐在gradle.properties中定义方便切换# gradle.properties DEBUG_BASE_URLhttp://172.20.10.13:8080/ TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_MODEL_ID你的模型ID然后在build.gradle里读取android { defaultConfig { buildConfigField String, DEBUG_BASE_URL, \${DEBUG_BASE_URL}\ buildConfigField String, TAOTOKEN_BASE_URL, \${TAOTOKEN_BASE_URL}\ buildConfigField String, TAOTOKEN_MODEL_ID, \${TAOTOKEN_MODEL_ID}\ } }代码里用BuildConfig.DEBUG_BASE_URL作为 Retrofit 或 OkHttp 的 baseUrl。这样你换热点、换网段时只改gradle.properties一行重新打包即可。3.3 如果你用 Cline / Claude Code 这类工具做联调有些同学会在 Cline 或 Claude Code 里直接调模型辅助调试。这类工具的配置也是三件套。以 Cline 的 MCP 配置为例在 settings 里填{ mcpServers: { taotoken: { url: https://taotoken.net/api, apiKey: sk-你的实际Key, model: 你的模型ID } } }如果你用的是 Codex 的auth.json结构类似{ baseURL: https://taotoken.net/api, apiKey: sk-你的实际Key, model: 你的模型ID }不管哪种工具Base URL、Key、Model ID 三件套缺一不可。填完之后工具侧的请求就会走 TaoToken 通道和你 Android 端访问的后端服务是两条独立的链路别混淆Android 端访问的是你本机的http://172.20.10.13:8080后端再按需转发到 TaoToken。3.4 网络权限别忘了Android 端要访问明文 HTTP 的局域网地址需要在AndroidManifest.xml里允许明文流量否则 Android 9 以上会直接拦截application android:usesCleartextTraffictrue ...生产环境当然要用 HTTPS但真机无线测试阶段用明文 HTTP 是常规操作。如果你只想对特定地址放行可以用network_security_config.xml精细控制这里不展开。4. 端口连通性验证与真机抓包核对4.1 先在本机验证服务监听状态服务启动后Windows 下确认监听netstat -ano | findstr :8080你应该看到0.0.0.0:8080处于LISTENING。如果看到的是127.0.0.1:8080说明后端没监听所有网卡手机一定连不上回去改启动参数。4.2 从另一台设备验证局域网连通性最直接的验证是用另一台连在同一热点的设备去 curl。如果手边没有第二台电脑可以用手机浏览器直接访问http://172.20.10.13:8080/health如果浏览器能返回健康检查结果说明局域网链路通了。如果转圈超时问题在网段或防火墙。Windows 防火墙经常拦入站临时放行netsh advfirewall firewall add rule nameDebug8080 dirin actionallow protocolTCP localport8080这条命令只是测试期临时用测完记得删掉。4.3 真机抓包确认请求命中手机端发起登录后怎么确认请求真的打到了你的后端两个办法。第一看后端访问日志如果日志里出现了手机发来的请求路径和手机 IP说明命中了。第二用抓包工具。Android 上可以用 Charles 或 Fiddler 做代理抓包但注意这属于本地调试代理配置时只针对你的调试设备。抓包时重点核对三样请求的 Host 是不是172.20.10.13:8080请求路径是不是你预期的登录接口响应码是不是 200。如果 Host 是127.0.0.1或localhost说明 Android 端 Base URL 没改对手机把请求发给了自己。如果 Host 对但连接超时回到 4.2 查防火墙和网段。4.4 一个完整的成功链路长什么样后端日志出现类似INFO: 172.20.10.5:52070 - POST /api/login HTTP/1.1 200 OK这里的172.20.10.5是手机在热点网段下的 IP52070是手机的临时源端口200 OK说明登录接口正常返回。到这一步真机无线测试的链路就算打通了APK 安装启动正常、手机能访问本机后端、登录接口返回正常。5. 本篇常见报错排查对照5.1 Failed to connect to /10.27.239.87:8080这个报错的关键信息是 IP 段10.x.x.x通常是校园网或公司网。手机和电脑虽然都联网但处于客户端隔离状态互相不可达。解决办法是换网络环境用手机热点让两者进同一网段。换完后重新 ipconfig 拿新 IP更新 Android 端 Base URL重新打包。5.2 failed to connect to /172.20.10.13 (port 8080) after 20000ms地址已经是热点网段了但还是超时。最常见的原因是测试手机当时没连到和电脑相同的热点。注意电脑连的是 A 手机的热点测试机却连着自己的流量或另一个 WiFi那自然不通。确认测试手机连的就是那个热点保持后端运行再试一次。另一个可能是 Windows 防火墙拦了入站按 4.2 放行。5.3 401 Unauthorized这个报错说明请求到达了服务端但鉴权没过。如果你在调试 TaoToken 通道检查 Key 是否填对、是否过期、Base URL 是否是https://taotoken.net/api。三件套里 Key 最容易出错复制时别带空格。如果 Key 没问题看 Model ID 是否和 Key 所属权限匹配。5.4 local proxy failed这个报错通常出现在你配了本地代理工具的场景。检查代理配置是否指向了正确的本地端口以及代理进程是否在运行。如果你并没有主动配代理检查系统环境变量里有没有残留的HTTP_PROXY/HTTPS_PROXY有的话清掉再试。5.5 reading choices 相关报错这类报错一般出现在调用模型接口、解析返回结构时。常见原因是返回体不是预期的 JSON 结构或者 Model ID 填错导致返回了错误信息。先确认 Base URL 和 Model ID再用 curl 直接打一次接口看原始返回curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的实际Key \ -H Content-Type: application/json \ -d {model:你的模型ID,messages:[{role:user,content:ping}]}看返回里有没有choices字段没有的话就是请求本身有问题。5.6 OAuth 相关报错如果你用的是 Claude Code 这类带 OAuth 流程的工具报 OAuth 错误通常是认证态失效或回调地址不匹配。重新走一遍授权流程确认回调地址和工具配置一致。如果工具支持 API Key 模式直接切到 Key 模式更省事避免 OAuth 的来回跳转。5.7 端口占用导致服务起不来报错类似Address already in use。用netstat -ano | findstr :8080找到占用进程的 PID再taskkill /PID pid /F结束掉或者直接换一个端口。换端口后记得 Android 端和 TaoToken 配置里的端口同步改。6. 把调试链路固定下来的几个实用习惯真机无线测试最容易反复踩的坑是每次换网络环境都要重新找 IP、改配置、重新打包。我的做法是把 IP 和端口做成可配置项而不是硬编码。Android 端用gradle.properties后端用.env两边都只改一处。TaoToken 的 Base URL 和 Key 也放环境变量这样换项目时复制一份配置就行。另一个习惯是先验证链路再验证业务。顺序永远是后端起来没、监听地址对不对、手机和电脑同网段没、IP 端口配对不对、最后才看登录逻辑。这个顺序能帮你把 80% 的“连不上”问题挡在业务代码之前。如果你需要长期做编码和 Agent 联调可以把 TaoToken 的 Coding Plan 用起来把模型调用和调试通道统一管理省得每个项目单独配。需要生成或管理 Key 的时候直接去控制台操作就行。真机无线测试这条链路配好一次之后后面就是改 IP 重打包的重复动作把配置项抽出来剩下的都是体力活。