移动端 QA 中的代理:模拟器、真机与 adb reverse——分步指南
引言:测试人员为什么需要在应用与服务器之间架设自己的代理
想象一下:你正在测试一个移动应用,点了一个按钮,屏幕上却弹出一个含糊的错误提示"出错了"。开发人员问你:"发了什么请求?返回了什么响应?状态码是多少?"。没有代理,你只能摊手;有了代理,你打开请求列表,复制服务器响应的内容,三十秒内就能附到缺陷单里。这就是只会"点点点"的测试人员和真正理解底层发生了什么的测试人员之间的差别。
本文刻意不同于面向普通用户的教程,那些教程教你如何把代理地址填进手机的 Wi-Fi 设置里。这里我们讲的是 QA 工程师的实际工作流程:在电脑上运行抓包代理,把 Android 模拟器的流量导入其中,通过 Wi-Fi 和 USB 连接真机并用 adb reverse 命令转发端口,以及抓取和替换测试环境的流量。普通用户在手机上设置代理,只是这个流程中的一小块拼图。
读完你能获得什么
- 一个可用的抓包代理(mitmproxy 或 Charles),能显示应用的每一个 HTTP 和 HTTPS 请求。
- 一个流量经过该代理的 Android 模拟器,包括加密流量。
- 一台通过两种方式连接到代理的真机:Wi-Fi 和通过 adb reverse 的 USB 数据线连接。
- 理解应用为什么"不信任"证书,以及如何在测试构建包上解决这个问题。
- 无需后端开发人员参与,就能替换测试环境响应、模拟慢速网络和服务器错误的技能。
本指南适合谁
适合希望看到网络流量而不是靠猜的手动测试人员和移动应用自动化测试人员。适合刚入职被要求"去看看 Charles"却没人解释那是什么、怎么用的初级工程师。也适合为团队搭建测试环境的开发人员。
需要提前掌握什么
对 HTTP 请求、响应、200 和 500 状态码有基本理解。会打开终端或命令行并执行命令。有在 Android 上安装应用的经验。如果你从没启动过模拟器——没关系,我们一起走完这条路。
需要多长时间
网络良好且已装好 Android Studio 的情况下,整篇指南大约需要一到两个小时。如果还没装 Android Studio,再加上 30-60 分钟下载系统镜像。第一次走通之后,在新项目上重新配置大约只需十分钟。
前期准备:工具、权限与系统要求
电脑上需要安装什么
- Android Studio 2025-2026 年的最新版本。安装时会一并装上 Android SDK、Android 模拟器和 adb 工具。这是核心工具集。
- 抓包代理。本指南演示两个选项:免费的 mitmproxy(在终端和 mitmweb 网页界面中工作)以及带免费试用模式的商业软件 Charles Proxy。选一个即可,另一个可以稍后再学。所有指令对两者都适用。
- Java 无需单独安装:Android Studio 使用内置的 JDK。
- 应用的测试构建包,格式为 APK。必须是 debug 构建或专门的 QA 构建,而不是商店里的正式版。为什么这一点至关重要——我们会在讲证书的部分解释。
系统要求
- 操作系统:Windows 10 或 11(64 位)、macOS 12 及以上、支持 KVM 的 Linux。
- 内存:最少 8 GB,舒适使用 16 GB。模拟器本身就要吃掉 2-4 GB。
- 可用磁盘空间:不少于 20 GB。一个 Android 系统镜像就有 1.5-2 GB,再加上 Android Studio 本身。
- BIOS/UEFI 中已开启硬件虚拟化(Intel VT-x 或 AMD-V)。没有它模拟器会慢得难以忍受或者根本启动不了。
- 一台 Android 8 及以上版本的真机,以及一根能传输数据的 USB 线(不是只能充电的)。
需要向团队申请的权限
- 测试环境地址(例如 https://api-stage.example-team.ru)和测试账号凭据。
- 应用的 debug 构建包或带"QA build"标记的构建包。向开发人员确认它是否信任用户证书、是否关闭了证书固定(certificate pinning)。
- 如果环境有 IP 白名单或需要连接公司内网——向管理员了解如何从你的工作电脑连接它。我们不讨论任何绕过限制的方法:只用团队授予的合规权限。
备份与安全
模拟器和设备上的代理设置都是完全可逆的。但开始前应该做两件事。第一,如果真机上已有可用的 Wi-Fi 设置或证书,给设置页面截个图——这样你能快速恢复原样。第二,最好使用专门的测试设备,而不是装有银行应用的私人手机:代理的根证书让持有者能够读取加密流量。在测试设备上是正常操作,在私人手机上则是风险。
注意:千万不要把抓包代理的根证书安装到装有银行和支付应用的私人设备上,也不要通过即时通讯工具把代理私钥文件传给同事。证书是在你的电脑本地生成的,就应该留在那里。
基础概念:流量抓取是怎么工作的
什么是抓包代理
普通代理是一个中间人,接收客户端请求并转发给服务器。抓包代理(也叫调试代理或中间人代理)做同样的事,但会保存每个请求和响应的副本,以友好的形式展示给你,并允许你暂停、修改和替换它们。对测试人员来说,这就像医生的 X 光机。
为什么 HTTPS 不能直接看到
现代流量几乎全部用 TLS 协议加密。代理能看到手机连上了服务器 api-stage.example-team.ru,但请求内容对它来说是一串加密流。为了解密,代理会生成自己的根证书(CA),并即时为每个网站签发伪造证书。手机必须信任这个根证书——否则应用会发现被替换,并以类似"Trust anchor for certification path not found"的错误断开连接。因此,在设备上安装代理证书是必需的一步。
Android 中的用户证书与系统证书
从 Android 7 开始,应用默认只信任系统证书,而忽略用户通过设置安装的证书。Chrome 浏览器是例外,它信任用户证书。要让你的应用信任代理证书,开发人员有两条正规路径:要么在 debug 构建中加入 network_security_config.xml 文件,允许信任用户证书;要么你在有 root 权限的模拟器上把证书装成系统证书。前者更简单,也更适合团队协作。
证书固定(Certificate pinning)
有些应用还会额外"钉住"服务器的特定证书,拒绝与任何其他证书配合,哪怕是受信任的。这在生产环境是很好的防护,但在测试环境中,pinning 通常会在 debug 构建中关闭。如果所有设置都做完了应用还是不走代理,就去问开发人员 pinning 的事。
模拟器如何看待你的电脑
Android 模拟器是一台拥有独立网络的虚拟机。在它内部,地址 127.0.0.1 指的是模拟器自己,而不是你的电脑。要从模拟器访问电脑,得用特殊地址 10.0.2.2。记住它——下面的命令里会出现。
什么是 adb 和 adb reverse
adb(Android Debug Bridge)是一个从电脑管理 Android 设备的命令行工具:安装应用、执行命令、转发端口。adb reverse 命令让设备上的端口"指向"你电脑上的端口。例如,执行 adb reverse tcp:8080 tcp:8080 之后,手机上的应用访问 localhost:8080 时,实际会到达电脑上代理正在监听的 8080 端口。它通过 USB 工作,不需要同一 Wi-Fi 网络,也不受公司热点限制的影响。反向命令 adb forward 则朝另一个方向工作:电脑的端口指向设备。别搞混了。
测试环境
环境(stage、staging、dev 环境)是应用服务端的测试副本。在环境上可以破坏数据、替换响应、查看日志。应用通常通过单独的构建包或隐藏菜单切换到测试环境。我们所有的流量抓取都针对测试环境,而不是生产环境。
第 1 步:在电脑上启动抓包代理
本阶段目标:电脑上的代理已运行,监听端口(mitmproxy 是 8080,Charles 是 8888),并且你知道电脑在局域网中的 IP 地址。
方案 A:mitmproxy
- 从项目官网下载适合你系统的 mitmproxy 安装包,或通过包管理器安装。macOS 上方便用 Homebrew,Windows 上是 .msi 安装包,Linux 上通过 pipx 或二进制压缩包。
- 打开终端(Windows 上是 PowerShell 或 Windows Terminal)。
- 用以下命令启动网页版:
终端会显示代理已在 8080 端口启动,浏览器会打开 127.0.0.1:8081 的网页界面。请求就会出现在这里。mitmweb --listen-port 8080 - 注意:mitmweb 界面运行在 8081 端口,而代理本身监听在 8080。在设备设置里你始终填 8080。
- 首次启动时 mitmproxy 会在用户主目录下创建 .mitmproxy 文件夹。里面有个 mitmproxy-ca-cert.cer 文件——这就是我们之后要装到设备上的根证书。
小贴士:如果你想完全在终端里工作、不用浏览器,就运行 mitmproxy 命令而不是 mitmweb。界面会是控制台的:方向键导航,Enter 打开请求,q 返回。自动化场景可用 mitmdump,它把流量写入文件。
方案 B:Charles Proxy
- 从官网下载 Charles,安装并启动。会出现主窗口,左侧是空的请求列表,右侧是 Overview、Contents 等标签页。
- 打开菜单 Proxy → Proxy Settings。在 Proxies 标签页确认端口为 8888,且"Enable transparent HTTP proxying"未勾选。点击 OK。
- 打开 Proxy → SSL Proxying Settings。勾选 Enable SSL Proxying。在 Include 块中点击 Add,添加主机 * 和端口 443。这样 Charles 就能解密所有 HTTPS。之后你可以把列表缩小到测试环境的域名。
- 如果 Charles 提议设置 macOS 或 Windows 的系统代理,拒绝它:我们需要的是手机流量,不是电脑浏览器的。可以通过 Proxy 菜单取消勾选 macOS Proxy 或 Windows Proxy 来关闭。
查询电脑的 IP 地址
真机通过 Wi-Fi 连接时需要电脑在局域网中的地址。
- Windows:在 PowerShell 中执行 ipconfig,找到活动 Wi-Fi 或以太网适配器的 IPv4 地址行。通常是类似 192.168.1.45 的地址。
- macOS:系统设置 → 网络 → 选择活动连接,详情里会显示地址。或者在终端执行 ipconfig getifaddr en0。
- Linux:命令 ip addr show 或 hostname -I。
记下这个地址。下文我们统称它为 192.168.1.45,请替换成你自己的。
在防火墙中开放端口
Windows 首次启动 mitmproxy 或 Charles 时会询问是否允许该程序接受连接。务必要对专用网络允许。如果弹窗没出现,就打开"Windows Defender 防火墙 → 允许应用通过防火墙",手动添加程序。macOS 在首次有外部连接时也会以类似方式询问权限。
检查:在电脑上打开浏览器,临时在其设置里指定代理 127.0.0.1 和端口 8080(或 8888),访问任意网站。mitmweb 或 Charles 里应出现请求行。检查完把代理从浏览器里撤掉,免得碍事。不想配置浏览器的替代方案是命令:
curl -x http://127.0.0.1:8080 -k https://example.com如果代理界面里出现了 example.com 那一行,说明代理工作正常。本阶段可能遇到的问题
- 端口被占用。出现类似"Address already in use"的消息。说明 8080 上已经有什么在监听了——常常是本地环境或别的工具。换个端口启动代理,比如 8082,后面全部用这个。
- mitmweb 没有打开浏览器。手动打开 127.0.0.1:8081 地址。终端里会打印带令牌的地址,整个复制过去。
- Charles 只显示 CONNECT 头,看不到 HTTPS 内容。没启用 SSL Proxying,或者 Include 里没加主机。回到方案 B 的第 3 点。
第 2 步:把 Android 模拟器的流量导入代理
本阶段目标:已启动的模拟器把所有 HTTP 和 HTTPS 请求发往你的代理,你能在界面里看到它们。
创建并启动模拟器
- 打开 Android Studio。如果没有已打开的项目,在起始界面选择 More Actions → Virtual Device Manager。项目内则是菜单 Tools → Device Manager。
- 点击创建设备按钮(加号或 Create Virtual Device)。
- 选择型号,比如 Pixel 8,点击 Next。
- 选择系统镜像。重要:要通过代理测试,用标有 Google APIs 的镜像比 Google Play 更方便。Google Play 镜像的 root 权限被锁,需要装系统证书时你就做不到了。对于 Android 14-16,这类镜像叫"Android 15.0 Google APIs x86_64"(Apple 处理器的电脑则是 arm64-v8a)。如果镜像旁边有下载箭头——先下载,需要 5-15 分钟。
- 最后一步给设备起个不带空格的名字,比如 Pixel_8_QA,点击 Finish。
- 用三角形按钮启动模拟器。首次启动需要 1-3 分钟。
方法 1:通过模拟器面板设置(最简单)
- 在已启动的模拟器窗口中,找到右侧的竖排面板。点击最下方的三个点——会打开 Extended Controls 窗口。
- 在左侧菜单选择 Settings,然后选 Proxy 标签页。
- 取消勾选"Use Android Studio HTTP proxy settings"。
- 选择 Manual proxy configuration。
- 在 Host name 字段输入 127.0.0.1。这里与 Android 内部的设置不同,模拟器是在宿主机层面应用代理,所以电脑地址写 127.0.0.1。
- 在 Port number 字段输入 8080(Charles 是 8888)。
- 点击 Apply。下方应显示"Proxy status: Success"。如果写着 Error——代理没启动或端口填错了。
方法 2:通过 adb 设置(灵活,适合脚本)
- 打开终端。确认 adb 可用:命令 adb devices 应显示类似 emulator-5554 device 的行。如果命令找不到,把 Android SDK 里的 platform-tools 文件夹加进 PATH(路径可在 Android Studio 中查看:Settings → Languages and Frameworks → Android SDK)。
- 执行:
这里我们已经处于 Android"内部",所以电脑用 10.0.2.2 表示。adb shell settings put global http_proxy 10.0.2.2:8080 - 检查设置是否生效:
应返回 10.0.2.2:8080。adb shell settings get global http_proxy - 要关闭代理,执行:
adb shell settings put global http_proxy :0
方法 3:启动时的命令行参数
如果你从终端启动模拟器(比如在 CI 或脚本中),加上这个标志:
emulator -avd Pixel_8_QA -http-proxy http://127.0.0.1:8080emulator 可执行文件位于 Android SDK 里的 emulator 文件夹。代理会应用到整个模拟器会话。
小贴士:写两个小脚本——proxy_on 和 proxy_off——里面就是方法 2 的 adb 命令。一天测试下来你会开关代理几十次,多余的菜单点击很累人。
验证流量已经走通
- 在模拟器里打开 Chrome 浏览器,用 HTTPS 访问任意网站。
- mitmweb 或 Charles 里应出现请求。Chrome 页面很可能会显示安全错误——这很正常,证书还没装。关键的是请求已作为带主机名和 CONNECT 方法的记录可见。
检查:代理界面里出现了你在模拟器中访问的网站域名行,且命令 adb shell settings get global http_proxy 返回你的代理地址和端口。两个条件都满足——模拟器就正确指向了代理。
可能遇到的问题
- 模拟器面板显示 Proxy status: Error。代理没启动,或者端口不对。启动 mitmweb 或 Charles,再点一次 Apply。
- 状态是 Success,但请求不出现。应用可能使用了自己的网络栈,忽略了系统代理(比如 Flutter 应用默认如此)。详见常见错误一节。
- 关闭代理后模拟器断网了。你很可能把 http_proxy 留成了空值而不是":0"。用带冒号和零的命令重新关闭,然后重启模拟器。
第 3 步:安装代理证书,解决信任问题
本阶段目标:模拟器和测试应用信任代理的根证书,你能看到 HTTPS 请求的明文内容:URL、请求头、请求体和响应体。
把证书装成用户证书
- 确认模拟器上代理已启用(第 2 步)。
- 在模拟器里的 Chrome 浏览器打开地址 mitm.it(mitmproxy)或 chls.pro/ssl(Charles)。这些是代理会拦截并返回证书下载页的特殊地址。如果你看到的不是页面而是普通网站或错误——流量没走代理,回到第 2 步。
- mitmproxy 点 Android 按钮,下载 mitmproxy-ca-cert.cer 文件。Charles 则直接下载。
- 在模拟器上打开设置 → 安全与隐私 → 更多安全设置 → 加密与凭据 → 安装证书 → CA 证书(某些版本路径是:安全 → 更多安全设置 → 加密与凭据)。会出现风险提示——点"仍然安装"。
- 在 Downloads 文件夹中选择下载的文件。如果模拟器要求设置屏幕 PIN 码,设一个简单的,比如 1234,并记住它。
- 安装后检查:加密与凭据 → 受信任的凭据 → 用户标签页。那里应出现 mitmproxy 或 Charles Proxy CA 条目。
不用浏览器的替代方式是先用 adb push 复制文件,再从文件管理器里选:
adb push ~/.mitmproxy/mitmproxy-ca-cert.cer /sdcard/Download/现在模拟器里的 Chrome 能无错打开任何 HTTPS 网站,代理里也能看到浏览器请求的明文。但你的测试应用很可能仍会报网络错误。进入关键部分。
应用为什么不信任,以及该向开发人员要什么
如基础概念中所述,Android 7 以上的应用忽略用户证书。正确的做法是让 debug 构建包含网络安全配置文件。开发人员在 res/xml/network_security_config.xml 中加入大致如下内容:
<network-security-config><debug-overrides><trust-anchors><certificates src='system' /><certificates src='user' /></trust-anchors></debug-overrides></network-security-config>并通过 android:networkSecurityConfig 属性在 AndroidManifest.xml 中引用它。debug-overrides 块只在调试构建中生效,所以正式版仍然安全。这是标准做法,多数团队已有这个文件。如果没有,把上面的片段复制到给开发人员的任务里。
注意:不要要求在基础配置里直接添加对用户证书的信任、不带 debug-overrides,也不要同意在正式版中关闭证书校验。那会削弱真实用户的安全防护。所有改动都应只涉及 debug 和 QA 构建。
备用路径:在 root 模拟器上装系统证书
如果构建没法为你改动,在 Google APIs 镜像(非 Google Play)的模拟器上可以把证书放进系统存储。这样任何未启用 pinning 的应用都会信任它。以下是 Android 14 及更新版本(系统证书位于 apex 分区)的简要步骤:
- 从终端带 -writable-system 标志启动模拟器。
- 执行 adb root,然后 adb remount。
- 用命令 openssl x509 -inform PEM -subject_hash_old -in mitmproxy-ca-cert.cer -noout 计算证书的 hash.0 文件名,把文件重命名为该值加后缀 .0(例如 c8750f0d.0)。
- 通过 adb push 把文件复制到系统证书存储区 /system/etc/security/cacerts/,然后重启模拟器。Android 14+ 还需要重新挂载系统加载证书的目录;mitmproxy 文档里有现成的脚本。
这条路更强,但也更脆弱:镜像一更新就全部重置,而且 Android 14+ 的步骤更复杂。日常工作中我们推荐第一条路,用 network_security_config。
安装测试应用
- 把 APK 放到方便的文件夹。
- 执行 adb install -r 路径/app-debug.apk。-r 标志会覆盖安装现有版本,保留数据。
- 10-30 秒后显示 Success,模拟器里出现应用图标。
检查:打开测试应用,在测试环境上登录。mitmweb 或 Charles 里出现了对测试环境域名的请求,点开任意一个能看到请求头、JSON 请求体和响应体的标签页。如果响应体可读——证书已安装且应用信任它。这是整篇指南最关键的检查点。
可能遇到的问题
- Chrome 能打开网站,但应用报网络错误。应用不信任用户证书。需要带 network_security_config 的构建包,或者系统证书。
- 应用日志(adb logcat)里看到"Certificate pinning failure"。启用了 pinning。请开发提供针对测试环境域名关闭 pinning 的 QA 构建包。
- mitm.it 显示页面"If you can see this, traffic is not passing through mitmproxy"。代理没生效。检查第 2 步的设置。
第 4 步:通过 Wi-Fi 连接真机
本阶段目标:与电脑处于同一 Wi-Fi 网络的真机把流量发往代理。
这是普通用户教程里的方式,但测试人员有自己的细节:需要理解它什么时候会失效,并能快速切换方案。模拟器不能替代真机:它没有真实摄像头,推送通知的到达方式不同,传感器和节能行为也不一样。因此网络场景必须用真机验证。
在 Wi-Fi 设置中配置代理
- 把手机连到与电脑相同的 Wi-Fi 网络。家用路由器没问题。公司访客网络往往不行,下面会讲。
- 打开设置 → 网络和互联网 → Wi-Fi(三星是:连接 → Wi-Fi)。
- 点击当前网络旁边的齿轮图标,或长按网络名调出菜单选"修改网络"。
- 展开"高级"或"高级设置"。
- 在代理项选择 手动。
- 代理主机名:你电脑的 IP 地址,例如 192.168.1.45。端口:8080 或 8888。"不使用代理的地址"字段留空。
- 保存。手机会重新连接网络。
在手机上安装证书
- 在手机上打开 Chrome,访问 mitm.it 或 chls.pro/ssl。下载证书。
- 设置 → 安全 → 加密与凭据 → 安装证书 → CA 证书 → 选择文件。三星、小米、华为的菜单名称略有不同,但逻辑一样:找"凭据"或"证书"字样。
- 通过 adb install 或直接从文件安装测试应用。
小贴士:在路由器设置里给电脑分配固定 IP(按 MAC 地址做 DHCP 保留)。否则路由器重启后地址会变,团队里所有手机都会停止走代理,你就要花半小时找原因。
Wi-Fi 方式不管用的时候
- 公司或访客网络中的客户端隔离(AP isolation)。设备能上网,但彼此看不见。症状:设置了代理的手机完全断网,mitm.it 打不开。检查方法:从电脑 ping 手机的 IP 地址(可在 Wi-Fi 属性里查看)。没有回应——存在隔离。
- 电脑和手机在不同子网。比如笔记本在有线网 10.10.0.x,手机在 Wi-Fi 192.168.1.x。
- 电脑防火墙拦截入站连接。尤其是 Windows 上网络被标记为"公用"时。把网络配置文件切到"专用"。
以上所有情况,解决办法只有一个——通过 USB 转发端口,接下来就讲。
检查:代理界面里出现了手机的请求,Charles 的 Client 列显示的是手机的 IP 而不是 127.0.0.1。打开测试应用做任意操作——对应的测试环境请求出现在列表里,且请求体已解密。
第 5 步:通过 adb reverse 转发端口——不用 Wi-Fi,用 USB 走代理
本阶段目标:只用 USB 线连接的真机把流量发往电脑上的代理,不受 Wi-Fi 网络影响。
这是办公室、共享办公空间以及任何你无权管理路由器的网络里最可靠的方式。思路:用 adb reverse 命令让手机上的 8080 端口指向电脑的 8080 端口。然后告诉手机使用代理 127.0.0.1:8080——也就是"自己",而 adb 会悄悄把数据包送到电脑上。
开启 USB 调试
- 在手机上打开设置 → 关于手机,连按七次"版本号"。会出现"您已成为开发者"的提示。小米手机需要连按"MIUI 版本"或"HyperOS 版本"。
- 回到设置 → 系统 → 开发者选项(三星在设置的根目录)。打开 USB 调试开关。
- 用数据线把手机连到电脑。手机上会出现"允许 USB 调试吗?"的请求,附带电脑的指纹。勾选"一律允许"并点允许。
- 在电脑上执行 adb devices。应出现带序列号和 device 字样的行。如果写着 unauthorized——看看手机屏幕,那里挂着请求。如果 offline——重新插拔数据线。
注意:使用支持数据传输的数据线。很多充电宝附带的廉价线只能充电。如果手机在充电但 adb devices 是空的——第一件事是换线,而不是重装驱动。
执行端口转发
- 确认电脑上的代理已启动并监听 8080 端口。
- 执行命令:
第一个数字是手机上的端口,第二个是电脑上的端口。命令会打印 8080 或什么都不打印——这都正常。adb reverse tcp:8080 tcp:8080 - 查看活动转发列表:
应出现类似 host-编号 tcp:8080 tcp:8080 的行。adb reverse --list - 如果连接了多个设备(比如模拟器和手机),用 -s 标志指定序列号:
adb -s R58M1234ABC reverse tcp:8080 tcp:8080
让手机把代理指向 localhost
这里有两条路。第一条通过 adb,最快:
adb shell settings put global http_proxy 127.0.0.1:8080第二条是在手机 Wi-Fi 设置里手动填,如同第 4 步,但主机字段填 127.0.0.1,端口 8080。某些系统里通过 adb 的全局设置不会应用到所有应用,这时就需要第二种方式。
注意一个重要细节。全局 http_proxy 设置由系统应用到当前网络连接上。如果 Wi-Fi 关着、手机走移动数据,部分系统仍会应用它,部分则不会。最可靠的做法是保持 Wi-Fi 开启(任意网络,哪怕连不到电脑),并在其设置里指定代理 127.0.0.1。通过 adb reverse 的流量会走 USB,与手机连的是哪个 Wi-Fi 网络无关。
安装证书
顺序和之前一样:Chrome → mitm.it → 下载 → 装成 CA 证书。如果第 4 步已在这台手机上装过证书,就不用重复。
工作结束后关闭转发
- 撤掉代理:adb shell settings put global http_proxy :0(或在 Wi-Fi 设置里选"无")。
- 取消转发:adb reverse --remove tcp:8080 或一次性全部取消:adb reverse --remove-all。
- 注意,拔掉数据线时转发会自动重置,但手机上的代理设置会保留。如果忘了撤掉,手机脱离数据线后就会断网。这正是新手最常见的抱怨:"手机什么都加载不出来"。
小贴士:给自己写个三行小抄:adb reverse tcp:8080 tcp:8080、adb shell settings put global http_proxy 127.0.0.1:8080、adb shell settings put global http_proxy :0。真机 90% 的工作场景,这三条命令就够了。
检查:关掉电脑的 Wi-Fi,或让手机处在无法访问电脑的网络中。执行 adb reverse,设置代理 127.0.0.1:8080,在手机 Chrome 里打开 mitm.it。证书下载页打开了——转发正常工作。然后打开测试应用,确认它的请求出现在代理里。
可能遇到的问题
- adb reverse 报"error: closed"或"more than one device"。连接了多个设备;用 -s 序列号指定。或者设备进入了 offline——重新插拔数据线。
- 转发有,但 mitm.it 打不开。检查电脑上的代理是否只监听 127.0.0.1 或全部接口,而不是只监听外部 IP。mitmproxy 默认监听所有接口。Charles 也是。
- 重新插拔数据线后流量断了。每次重新连接 adb reverse 都会重置。再执行一次命令即可。手机上的代理设置会保留。
第 6 步:抓取并替换测试环境流量
本阶段目标:你会过滤发往测试环境的请求、读取请求和响应体、暂停请求并替换服务器响应、模拟错误和慢速网络,还能通过 adb reverse 把应用指向本地后端。
只过滤需要的内容
应用会发几十个后台请求:埋点、配置更新、版本检查。为了避免淹没其中,按测试环境域名设置过滤。
- 在 mitmweb 顶部过滤框输入类似 ~d api-stage.example-team.ru 的表达式——只留下发往该域名的请求。表达式 ~u /orders 按 URL 片段过滤,~c 500 只显示 500 状态码的响应,~m POST 只显示 POST 请求。表达式可以用空格组合。
- 在 Charles 中启用 Focus 模式:右键点击测试环境的主机 → Focus。其他主机会折叠进 Other Hosts 分组。下方 Filter 字段还能输入 URL 片段进一步过滤。
阅读请求与响应,便于附到缺陷单
- 点击请求行。mitmweb 右侧出现 Request、Response、Detail 标签页。Charles 则是 Overview、Contents、Summary 标签页,下方有 Headers、JSON Text、Raw 切换器。
- 把 URL、方法、响应码和 JSON 响应体复制出来。mitmweb 可以右键请求选 Export → curl:得到一条命令,开发人员一秒钟就能在本地复现。Charles 同理:右键 → Copy cURL Request。
- 一份好的网络错误缺陷报告总是包含:复现步骤、带方法的 URL、响应码和响应体、请求时间(便于在服务端日志里查找),以及后端返回时附带的请求标识头(通常是 X-Request-Id)。
暂停请求并修改响应
经典场景:需要验证应用如何展示含一百件商品的购物车或负价格,而测试环境没有这种数据。替换响应即可。
- 在 mitmweb 的 Intercept 框输入过滤条件,例如 ~u /cart。此后所有该 URL 的请求都会被暂停。在应用中执行操作。请求会带上 intercepted 标记出现。点击它,编辑 Response 标签页里的内容(铅笔图标)后点 Resume。应用就会收到修改后的数据。
- 在 Charles 中启用断点:右键请求 → Breakpoints。下次同类请求时会弹出窗口,分两个阶段:先 Edit Request,再 Edit Response。在 Response 标签页修改 JSON,点 Execute。
- 注意应用有超时,通常 10-30 秒。如果你编辑响应超过这个时间,应用会显示网络错误而不是你的数据。提前在文本编辑器里准备好 JSON,然后整体粘贴。
持续替换响应:Map Local
如果场景反复出现,手动暂停就不方便了。Charles 有 Tools → Map Local:指定 URL 和本地 JSON 文件,之后每个这类请求都会收到文件内容而不是测试环境的响应。mitmproxy 的对应功能是 map_local 选项,指定 URL 模板和文件路径;也可以写小的 Python 脚本,用 response 函数修改任意字段。比如五行脚本就能把所有测试环境响应里的 balance 字段替换成你需要的数值。
模拟服务器错误
应用在遇到 500、401 或空响应时表现如何?在测试环境上很难验证,通过代理却很容易。Charles 里:Tools → Rewrite → 为测试环境 URL 添加一条 Response Status 类型、值为 500 的规则。mitmproxy 里:在拦截模式中改响应编辑器里的状态码,或者用脚本设置 flow.response.status_code = 500。检查应用是否显示清晰的错误,而不是崩溃或卡在无限加载上。
模拟慢速网络
在 Charles 中启用 Proxy → Throttle Settings,选择 3G 预设或自定义参数:带宽、延迟、丢包率。别忘了把 Throttle 限制在测试环境主机上,否则其他连接也会变慢。测试列表加载、离开页面时取消请求、以及超时时的行为。Android 模拟器也能限速:Extended Controls → Cellular → Network type,但代理提供更精细的控制。
把应用指向本地后端
常见任务:开发人员在自己笔记本的 3000 端口起了服务,请你在发布到测试环境前验证功能。真机上的应用看不到它的 localhost。解决办法还是 adb reverse:
adb reverse tcp:3000 tcp:3000然后在应用中(通过隐藏的环境切换菜单或 QA 构建里的 base URL 设置)指定地址 http://localhost:3000,请求就会发到电脑上。如果同时还需要抓包,保持代理开启:mitmproxy 会把发往 localhost:3000 的请求当普通请求看待。模拟器上不用 adb reverse,直接用地址 http://10.0.2.2:3000 即可。
小贴士:保存会话。Charles 里是 File → Save Session,mitmproxy 里是 mitmdump -w session.mitm 命令或 mitmweb 里的保存按钮。带复现的会话文件比任何描述都有价值:开发人员打开它,就能看到所有请求按你当时的顺序排列。
检查:你能做到:只显示发往测试环境的请求;把任意请求复制成 curl;暂停请求并把修改后的 JSON 返回给应用、让它在屏幕上显示;让应用收到 500 状态码并看到它的反应;限速并看到加载指示器。这五点都做到了,你就达到了熟练使用代理的水平。
结果验证:最终检查清单
过一遍清单,每项都打勾。全部完成,环境才算完全准备好投入日常工作。
电脑上的代理
- mitmweb 或 Charles 无错启动并监听自己的端口。
- 命令 curl -x http://127.0.0.1:8080 -k https://example.com 能在界面里显示请求。
- 找到根证书文件,你知道它放在哪。
模拟器
- adb devices 显示模拟器状态为 device。
- adb shell settings get global http_proxy 返回 10.0.2.2:8080,或 Extended Controls 面板显示 Success。
- 模拟器里的 Chrome 能无警告打开 HTTPS 网站。
- 安全设置的用户标签页里能看到证书。
- 测试应用正常工作,发往测试环境的请求可见且请求体已解密。
真机
- USB 调试已开启,adb devices 能看到手机。
- Wi-Fi 方式:代理指向电脑 IP,mitm.it 能打开,应用请求可见。
- USB 方式:adb reverse --list 显示 tcp:8080,代理设为 127.0.0.1:8080,在电脑 Wi-Fi 关闭时 mimt.it 也能打开。
- 你会关闭代理和转发,关闭后手机能正常上网。
与测试环境协作
- 已设置测试环境域名过滤。
- 已通过暂停或 Map Local 至少完成一次响应替换。
- 已验证应用对 500 状态码的反应。
- 已保存一个带流量示例的会话。
自测小场景
- 启动代理、模拟器,并在模拟器上启用代理。
- 打开应用,登录,打开任意数据列表。
- 在代理里找到返回该列表的请求。对其 URL 设置拦截。
- 在应用里刷新列表,在暂停的响应里删掉一半元素,放行。
- 应用屏幕上应显示更少的元素。如果是——环境完全可用。
常见错误与解决办法
问题 1:应用报网络错误,浏览器却正常
原因:应用不信任用户证书(Android 7+ 的默认行为),或启用了证书固定(certificate pinning)。解决:申请带 network_security_config 和 debug-overrides 块的 debug 构建包,或针对测试环境关闭 pinning 的 QA 构建包。在 Google APIs 模拟器上装系统证书是临时方案。用 adb logcat 过滤 Trust 或 pinning 字样有助于定位原因。
问题 2:设置了代理却完全没有请求
原因:应用使用的网络库忽略了系统代理。Flutter 应用(dart:io 客户端)、部分 React Native 构建和 gRPC 应用都有这种表现。解决:对于 Flutter,开发人员在 debug 构建中通过读取代理设置的包来支持系统代理,或在调试模式下把 findProxy 显式设为 10.0.2.2:8080。这是标准请求,Flutter 开发人员都知道。替代方案是透明代理模式,但它更复杂,这里不展开。
问题 3:测试完手机断网了
原因:Wi-Fi 设置或全局 http_proxy 里还留着代理,而代理服务器已关闭或数据线已拔。解决:adb shell settings put global http_proxy :0,并把 Wi-Fi 设置里的代理改成"无"。把这个动作加到你的工作收尾流程里。
问题 4:adb 看不到设备
原因:数据线只能充电、未确认调试请求、Windows 没装驱动、设备处于"仅充电"模式而非"传输文件"模式。解决:换线,检查手机屏幕,在通知栏把 USB 模式切换到"传输文件",在 Windows 上通过 SDK Manager 安装 Google USB Driver 或厂商驱动。adb kill-server 然后 adb start-server 也有帮助。
问题 5:Charles 只显示 CONNECT,没有内容
原因:没启用 SSL Proxying,或域名没加进 Include。解决:Proxy → SSL Proxying Settings → Enable → Add 主机 * 端口 443。启用后重新打开应用:已经建立的连接不会追溯解密。
问题 6:模拟器面板显示 Proxy status: Error
原因:电脑上的代理没启动或端口不对。有时是 Android Studio 用自己的代理覆盖了设置。解决:启动代理,取消勾选使用 Android Studio 设置,再点一次 Apply。还不行就用 adb 命令、以 10.0.2.2 地址设置代理。
问题 7:mitm.it 打不开,但其他网站正常
原因:流量没走代理。真机通过 Wi-Fi 时,往往是网络里的客户端隔离导致。解决:从电脑 ping 手机。没有回应——改用 adb reverse。有回应——检查防火墙和端口。
问题 8:Android Studio 更新后证书不见了
原因:你对模拟器做了 Wipe Data 或重建了它。解决:用户证书通过 mitm.it 一分钟就能装好。为了不丢状态,使用模拟器快照(Extended Controls 里的 Snapshots):装好证书和应用后保存快照。
问题 9:多个设备时命令用错了对象
原因:连接两个及以上设备时,不带 -s 标志的 adb 会拒绝工作或作用到意外的设备上。解决:始终使用 adb -s 序列号,序列号通过 adb devices 查看。也可以把环境变量 ANDROID_SERIAL 设为需要的编号。
进阶测试人员的更多能力
iOS 模拟器与真机 iPhone
逻辑一样,工具不同。iOS 模拟器使用 macOS 的网络设置,所以代理在 Mac 的系统网络设置里指定,证书拖进模拟器窗口并在设置 → 通用 → 关于本机 → 证书信任设置里启用。真机 iPhone 在 Wi-Fi 属性里设置代理,证书通过 mitm.it 下载,并按同样路径启用信任。iPhone 没有对应的 USB adb reverse;在封闭网络里可以从 Mac 通过数据线共享网络。
用 mitmdump 和脚本做自动化
mitmdump 无需界面即可运行,接受 Python 脚本。举个任务:把所有测试环境响应里的 feature_flags 字段替换掉,从而在没有管理后台权限的情况下开启实验功能。脚本通过 -s script.py 标志运行,流量通过 -w 标志写入文件。这类脚本适合和自动化测试一起存放在测试仓库里。
与 Appium 和自动化测试集成
自动化测试中,会话启动前先开启代理:通过 adb 设置,然后不仅对 UI 做断言,还对流量做断言。比如测试点"支付"按钮后,验证 mitmproxy 里出现了一个发往 /payments 的 POST、金额正确。这能抓住 UI 看不见的缺陷:请求重复、发送多余字段、日期格式错误。
验证埋点与追踪
代理是测试埋点事件不可或缺的工具:你能看到应用在每次操作时发送了哪些事件、带什么参数。按埋点系统域名过滤,再看请求体那一列,就不用苦等事件出现在看板上了。
多个模拟器配不同代理
如果需要对比测试环境不同响应下的行为,启动两个代理(端口 8080 和 8090)和两个模拟器,各自通过 adb -s 配置代理。这样验证 A/B 方案很方便:一个模拟器通过 Map Local 收到替换的响应,另一个收到原始响应。
用模拟器快照作为干净环境
配置好代理、证书和应用后,保存模拟器快照。每次测试运行前加载它——几秒钟就得到一模一样的坏境,无需重新安装。
环境隔离与安全
为不同项目保持独立的 Charles 配置文件或 mitmproxy 配置。不要系统级地抓取电脑上的全部流量——只抓设备流量。并定期检查测试设备上没有个人账号,因为它们的全部流量在代理里都可见。
FAQ:移动端测试代理设置的常见问题
adb reverse 和 adb forward 有什么区别?
adb reverse 让设备上的端口指向电脑:手机上的应用访问 localhost 就到达了电脑。adb forward 则相反:电脑的端口指向设备,比如用来连接调试器或手机内部的 web 服务。代理和本地后端需要的正是 reverse。
如果我只关心请求的 URL,也必须装证书吗?
不必。没有证书你能看到主机和 CONNECT 请求,但看不到路径、参数和请求体。不过应用此时会收到 TLS 错误,没法正常测试。实践中证书总是要装的。
为什么模拟器上电脑地址是 10.0.2.2,而 Extended Controls 面板里要填 127.0.0.1?
模拟器面板是在宿主机一侧应用代理,所以那里电脑地址是 127.0.0.1。而 adb shell 命令在 Android 内部执行,那里 127.0.0.1 是模拟器自己,电脑要通过 10.0.2.2 访问。记住规则:Android 内部用 10.0.2.2,外部用 127.0.0.1。
不 root 也能在设备上用代理吗?
可以。本指南讲的所有内容,除了安装系统证书,都不需要 root。关键条件是 debug 构建包信任用户证书。
构建包更新后应用突然不走代理了,怎么办?
很可能是开发人员启用了 pinning 或去掉了 debug-overrides。用 adb logcat 检查证书相关错误,并向团队确认网络配置有什么改动。这通常发生在切换到新的 HTTP 客户端库时。
用移动数据而不是 Wi-Fi 时,如何让应用走代理?
通过 USB 使用 adb reverse,并做全局设置 http_proxy 127.0.0.1:8080。多数设备上代理也会应用到移动数据。如果不行——就用 Wi-Fi 测试,网络切换场景另外单独验证、不开代理。
能抓取商店里正式版应用的流量吗?
从技术上说不可以,正式版构建不信任用户证书且常有 pinning,不做修改无法工作。这是对的:保护用户比测试人员方便更重要。所有验证都在测试构建包和测试环境上做。
怎么判断请求是应用发的,而不是后台服务或浏览器发的?
Charles 在 macOS 上有 Client Process 列,而在设备上不传递进程信息。实用做法:关掉其他所有应用,按测试环境域名过滤,逐个精确复现操作。有疑问时看 User-Agent 头——应用通常会带上自己的名称和版本。
如何保存流量并交给开发人员?
Charles 里 File → Save Session As,格式为 .chls,或导出为 HAR。mitmproxy 里用 -w 标志记录,或在网页界面里保存。HAR 几乎能被所有工具读取,包括浏览器开发者工具的 Network 标签页。
第一次之后,每天的配置要花多长时间?
启动代理、从快照启动模拟器、通过 adb 开启代理——大约一分钟。真机 USB 方式——两条命令、十秒钟。证书设置只在设备重置后需要重做。
结语
我们来总结一下。你在电脑上启动了抓包代理,并确认它能看见流量。你用三种不同方式把 Android 模拟器指向了它,并搞清楚了 127.0.0.1 与 10.0.2.2 的区别。你安装了根证书,理解了应用为什么不信任它、以及该向开发人员要什么。你通过 Wi-Fi 连接了真机,碰到了办公网络的限制,并用 adb reverse 端口转发解决了它。你学会了过滤测试环境流量、暂停请求、替换响应、模拟服务器错误和慢速网络,还能把应用指向同事的本地后端。
这套技能正是移动应用测试人员能独立发现并定位网络缺陷的标志。你的缺陷报告会更精确,开发人员也会感谢你提供的现成 curl 命令和会话文件。
接下来做什么
- 在自己的工作项目上重做一遍配置,做到发往测试环境的请求都能解密显示。
- 整理一份自己的 adb 命令小抄,并保存配好环境的模拟器快照。
- 带着开启的代理完整跑一轮功能测试,数一数因为流量可见而发现了多少缺陷。
往哪个方向进阶
下一阶段是用 Python 写 mitmproxy 脚本自动替换响应、把流量校验集成到 Appium 自动化测试里,以及在移动客户端之外用 Postman 或 curl 直接测试测试环境 API。学习 TLS 基础和证书结构也很有用,这样能自信地与开发人员讨论 pinning 和网络安全配置。最后一定要掌握 iOS 部分:能同时测试两个客户端的工程师很受重视,因为他们在两个平台上都同样游刃有余。你一定能做到——最难的部分你已经完成了。