1. 项目概述为什么需要录制手机APP的接口测试脚本作为一名在测试领域摸爬滚打了十多年的老鸟我见过太多测试同学在面对移动端APP接口测试时还在用最原始的方式打开Fiddler或Charles抓包然后手动在JMeter里一个请求一个请求地复制粘贴URL、Header和Body。效率低不说还容易出错特别是遇到那些参数复杂、依赖Cookie或Token的接口简直是噩梦。所以今天我想跟你分享一个能极大提升效率的“懒人”方法用JMeter直接录制手机APP的操作自动生成接口测试脚本。这不仅仅是把“抓包”和“写脚本”两个步骤合二为一更重要的是它能完整地记录下你操作APP时产生的所有网络请求包括那些容易被忽略的静态资源请求、心跳包、埋点上报等为你构建一个最贴近真实用户行为的测试场景打下坚实基础。简单来说这个方法的核心价值在于自动化、保真度高、可复用性强。无论是给开发做冒烟测试还是为性能测试准备基础脚本亦或是做接口回归测试它都能让你从重复的机械劳动中解放出来把精力更多地放在测试用例设计和结果分析上。接下来我就手把手带你走通整个流程并分享一些我踩过坑才总结出来的实战经验。2. 环境准备与核心原理拆解在开始动手之前我们必须把“舞台”搭好并理解背后的工作原理。这样当遇到问题时你才能知道从哪里入手排查而不是盲目地试错。2.1 工具清单与安装要点你需要准备以下几样东西JMeter主角负责录制和生成脚本。建议从官网下载最新稳定版。安装就是解压没什么难度。但有个关键点确保你的电脑已经安装了合适版本的JavaJDK 8或11比较稳妥。启动时如果报错十有八九是Java环境问题。测试手机Android或iOS均可。本文将以Android为例因为其代理设置更为通用。iOS的原理完全一样只是在Wi-Fi代理设置上路径略有不同。网络环境确保你的电脑和手机连接在同一个局域网Wi-Fi下。这是整个方案能跑通的基础。你可以用电脑开热点给手机连或者让手机和电脑都连上同一个路由器。注意很多公司内网有安全策略可能会禁止或干扰代理流量。如果你在办公室操作失败可以尝试切换到手机热点网络环境进行。2.2 核心原理代理Proxy是如何工作的录制脚本的本质是让JMeter扮演一个“中间人”Man-in-the-Middle的角色。这个过程可以分解为三步拦截你在JMeter中启动一个HTTP(S)代理服务器默认端口8888。然后在手机的Wi-Fi设置中手动配置代理将代理服务器指向你电脑的IP地址和JMeter代理的端口。转发与记录此后手机APP发出的所有HTTP/HTTPS网络请求都会先被发送到你电脑上的JMeter代理服务器。生成脚本JMeter代理收到请求后一方面会将请求原样转发给真正的目标服务器APP的服务器另一方面它会把这个请求的所有细节方法、URL、头信息、参数、Cookie等记录下来并自动转换成JMeter的采样器如HTTP Request保存到你指定的线程组中。这就好比你要寄一封信网络请求本来直接投递到邮筒服务器就行。但现在你请了一位秘书JMeter代理你把信先给秘书秘书复印一份存档录制脚本然后把原件寄出。手机APP和服务器之间的通信完全不受影响但完整的“通信记录”已经在你手上了。理解了这个你就明白为什么必须保证电脑和手机在同一网络因为手机需要能通过网络找到你电脑上运行的JMeter代理服务。3. 详细操作步骤从零开始录制第一个脚本理论讲完我们进入实战环节。我会以测试一个简单的“天气查询APP”为例假设它的服务器接口是api.weather.com。3.1 第一步在JMeter中配置代理录制器启动JMeter进入你的JMeter解压目录的bin文件夹双击jmeter.bat(Windows) 或执行./jmeter(Mac/Linux) 启动。创建测试计划Test Plan默认会新建一个。建议先保存给它起个有意义的名字比如手机APP接口录制模板.jmx。添加线程组Thread Group右键点击Test Plan-Add-Threads (Users)-Thread Group。这个线程组将作为我们录制下来的请求的“容器”。你可以给它重命名为“录制容器”。添加HTTP(S) Test Script Recorder这是核心组件。右键点击Test Plan注意不是线程组-Add-Non-Test Elements-HTTP(S) Test Script Recorder。配置代理录制器Global SettingsPort默认是8888如果被占用可以改成其他比如8899。记住这个端口号。Target Controller选择我们刚才创建的“录制容器”线程组。这意味着录制的请求都会放到这个组里。HTTP(S) Test Script Recorder界面下方有几个标签页我们重点关注Requests FilteringInclude Patterns添加包含模式。比如我们的天气接口都是/api/v1/*这样的我们可以添加一个.*/api/v1/.*的正则表达式这样只录制接口请求过滤掉图片、CSS等静态资源。这是保持脚本整洁的关键一步Exclude Patterns添加排除模式。如果你知道某些域名或路径肯定不需要比如数据分析SDK的域名sdk.analytics.com可以在这里排除。Start先别急着点我们需要先配置好证书针对HTTPS和手机端。3.2 第二步处理HTTPS流量关键且易错现在的APP几乎全部使用HTTPS。JMeter要解密HTTPS流量必须让手机“信任”它颁发的证书。生成JMeter根证书在JMeter的bin目录下有一个叫ApacheJMeterTemporaryRootCA.crt的文件。启动JMeter后这个文件才会生成。如果找不到你可以先点一下上一步的Start按钮JMeter会提示你证书存放路径通常就在bin目录下。将证书发送到手机并安装你可以通过邮件、微信文件传输助手或数据线把这个.crt文件传到手机上。Android手机在文件管理器中找到该证书点击安装。系统会要求你给证书起个名字比如“JMeter Proxy”并选择用途选择“VPN和应用”或“WLAN”均可。安装时可能需要输入锁屏密码。iOS手机用Safari浏览器访问一个能下载该证书的链接比如你把证书放在一个网页服务器上或者用隔空投送下载后进入设置-通用-描述文件与设备管理找到该证书并安装。安装后还必须进入设置-通用-关于本机-证书信任设置找到刚刚安装的JMeter根证书手动开启完全信任。这一步很多人会漏掉实操心得iOS的证书信任步骤是最大的坑。很多同学录不到HTTPS请求就是因为只安装了证书没去“证书信任设置”里开启信任。务必检查3.3 第三步手机端配置代理获取你电脑在局域网内的IP地址。Windows在命令行输入ipconfig查看“无线局域网适配器 WLAN”或“以太网适配器”下的IPv4 地址。Mac/Linux在终端输入ifconfig或ip addr找到对应网卡的inet地址。在手机上进入当前连接的Wi-Fi设置。Android长按Wi-Fi网络 - 修改网络 - 高级选项 - 代理 - 选择“手动”。主机名填电脑IP端口填JMeter代理设置的端口默认8888。iOS点击Wi-Fi网络右边的i图标 - 配置代理 - 选择“手动”。服务器填电脑IP端口填8888。保存设置。3.4 第四步开始录制与操作APP回到JMeter点击HTTP(S) Test Script Recorder上的Start按钮。可能会弹出提示直接点OK。现在JMeter的代理服务器已经开始在8888端口监听了。操作你的手机APP。比如打开天气APP刷新天气切换城市等。你所有的网络操作都会被JMeter捕获。观察JMeter的“录制容器”线程组你会看到采样器Sampler在不断增加每个都代表一个被捕获的HTTP请求。3.5 第五步停止录制与清理在APP上完成你想要录制的操作流程后回到JMeter点击Stop按钮停止录制。非常重要立即回到手机Wi-Fi设置将代理从“手动”改回“无”。否则手机在断开当前Wi-Fi前都无法正常上网。在JMeter中右键点击“录制容器”线程组 -Save as将录制好的脚本保存为.jmx文件。至此一个最基础的录制流程就完成了。你得到的是一个包含了所有请求的“毛坯”脚本。4. 脚本优化与增强从“能用”到“好用”直接录制的脚本通常很“脏”包含大量无关请求且缺乏灵活性。我们需要对它进行加工。4.1 请求清理与过滤删除静态资源请求通常.js,.css,.png,.jpg,.gif,.ico等资源的请求对接口测试无意义。你可以根据URL后缀批量删除。在JMeter的“查看结果树”中预览然后在线程组里右键删除。合并重复请求有些接口如心跳包、上报会被反复调用。对于测试来说可能只需要保留一个样本。仔细检查删除多余的。使用“仅错误日志”在测试计划层级添加一个监听器View Results Tree但在调试时将其设置为“仅错误日志”模式可以避免录制时产生的海量成功请求日志拖慢JMeter。4.2 参数化与关联这是将录制脚本转化为可复用、健壮测试脚本的灵魂。识别动态参数查看录制的请求找出那些每次运行都会变化的值。最常见的有token/authorization: 用户认证凭证。timestamp: 时间戳。nonce: 随机数。某些接口返回的ID用于后续请求如创建订单返回order_id用于查询订单。使用变量替换对于token 你可以先录制一个登录请求然后用JSON Extractor或正则表达式提取器后置处理器从登录响应中提取token存入一个JMeter变量如${ACCESS_TOKEN}。在后续所有需要token的请求头或参数中不再使用录制时的固定值而是使用${ACCESS_TOKEN}。对于时间戳可以使用JMeter内置函数${__time()}来动态生成。示例提取Token在登录请求下添加后置处理器 -JSON Extractor。Names of created variables: 填ACCESS_TOKEN。JSON Path Expressions: 填$.data.token根据你登录接口实际的JSON结构来写。Match No.: 填1。然后在另一个需要认证的请求中在Header Manager里添加一条Authorization: Bearer ${ACCESS_TOKEN}。4.3 添加断言Assertion没有断言的测试脚本是没有灵魂的。断言用来验证服务器的响应是否符合预期。响应状态码断言最基础的确保返回200。添加Response Assertion测试字段选择“响应代码”模式匹配规则“等于”模式填200。响应内容断言更细粒度的检查。例如登录成功后响应JSON里通常会有code: 0或success: true。添加JSON Assertion或Response Assertion来检查这些关键字段。响应时间断言添加Duration Assertion设置一个合理的最大响应时间阈值如3000毫秒用于性能基线测试。4.4 组织测试结构一个好的脚本应该结构清晰仅一次控制器Once Only Controller把登录请求放在这里面保证整个线程组运行期间只登录一次。事务控制器Transaction Controller把一个业务操作相关的多个请求组合在一起比如“添加商品到购物车-结算-支付”。事务控制器可以统计这组请求的总耗时非常有用。模块控制器Module Controller如果你有多个测试场景如浏览商品、下单、查看订单可以把每个场景做成独立的“线程组”或“简单控制器”然后用模块控制器来调用实现脚本的模块化和复用。5. 常见问题排查与实战技巧录制过程中你肯定会遇到各种问题。这里是我总结的“排坑指南”。5.1 问题一手机配置代理后无法上网/APP无法连接网络可能原因1电脑防火墙阻止了JMeter代理端口。解决在电脑防火墙设置中为JMeterjava.exe或指定的端口如8888添加入站规则允许连接。可能原因2电脑IP地址输入错误。解决确保你输入的是电脑在当前Wi-Fi下的局域网IP而不是公网IP或127.0.0.1。可能原因3JMeter代理未成功启动。解决检查JMeter界面是否有错误提示。尝试更换一个端口如8899重启JMeter代理。5.2 问题二能抓到HTTP请求但抓不到HTTPS请求请求失败或内容为空可能原因1手机未正确安装或信任JMeter根证书。最常见解决严格按照上文“第二步”操作特别是iOS用户务必去“证书信任设置”里启用完全信任。可能原因2APP使用了证书绑定SSL Pinning。解决这是一种高级安全机制APP只信任自己的证书不信任用户安装的根证书。对于这类APP常规代理录制方法失效。解决方案通常需要反编译APP并修改代码这超出了基础测试范围可能需要开发协助或使用更专业的移动测试工具。可能原因3JMeter的HTTP(S) Test Script Recorder中未正确配置。解决在Recorder的配置中HTTPS Domains可以填*表示捕获所有HTTPS域名但这不是必须的。更常见的是在Requests Filtering里确保没有错误地排除了你的目标域名。5.3 问题三录制到的请求太多太杂包含大量图片、字体等资源解决充分利用Requests Filtering。在Include Patterns中只添加你关心的接口路径模式如.*/api/.*。在Exclude Patterns中添加常见的静态资源后缀如.*\.js,.*\.css,.*\.png,.*\.jpg,.*\.gif,.*\.ico,.*\.woff,.*\.woff2。这样JMeter在录制时就会直接过滤掉这些请求让你的脚本从一开始就保持干净。5.4 问题四录制的脚本回放失败与录制时状态不一致可能原因1参数未进行关联。比如登录后的session或token是写死的过期后脚本就失败了。解决按照“4.2 参数化与关联”章节将动态参数提取为变量。可能原因2请求顺序或依赖问题。某些请求需要前一个请求的返回结果作为参数。解决仔细分析业务逻辑确保脚本中的请求顺序与真实操作一致并正确提取依赖参数。可能原因3服务器有防爬虫或频率限制。解决在JMeter中增加合理的思考时间Timer模拟真人操作间隔。检查请求头是否完整特别是User-Agent、Referer等有时服务器会校验这些信息。5.5 高级技巧使用Fiddler/Charles作为“前置代理”有时JMeter自带的代理录制器对某些复杂APP的支持不够好。你可以采用一个更稳定的组合方案用Fiddler或Charles抓包再导出为JMeter脚本。用Fiddler/Charles正常抓取手机APP流量。这两个工具对HTTPS的支持和流量解析通常更友好。在Fiddler/Charles中将抓取到的会话Session全部选中。导出这些会话。Fiddler可以导出为SAZ文件Charles可以导出为chls文件。使用第三方工具如BlazeMeter的 Chrome 插件或开源工具HAR to JMeter将这些文件转换成JMeter的.jmx脚本。这个方法的优点是录制过程更稳定直观缺点是多了格式转换的步骤。你可以根据实际情况选择。6. 将脚本投入实战接口自动化与性能测试一个优化好的录制脚本其价值才刚刚开始体现。用于接口自动化回归 你可以将脚本保存为模板。以后每次发版只需用这个脚本快速跑一遍核心业务流程验证主要接口是否正常。结合JMeter的-n -t test.jmx -l result.jtl命令行模式可以轻松集成到Jenkins等CI/CD流水线中实现每日构建后的自动接口回归测试。用于性能测试准备 录制脚本是构建性能测试场景的第一步。你需要参数化将用户、商品ID等数据放入CSV文件使用CSV Data Set Config来读取模拟不同用户的行为。控制并发调整线程组的“线程数”用户数、“循环次数”和“Ramp-Up时间”。添加监听器添加Aggregate Report、Response Times Graph等监听器用于分析性能结果。分布式测试如果单台机器压力不够可以使用JMeter的分布式测试功能用多台机器同时施压。从我个人的经验来看花时间掌握“录制-优化”这套组合拳前期看似多了一步但从整个测试活动的生命周期来看它节省的时间是巨大的特别是当业务频繁迭代接口经常变动时你可以快速重新录制、对比、更新脚本维护成本远低于完全手写。记住好的测试工程师不仅是问题的发现者更是效率的创造者。
