做接口测试时，遇到需要登录的接口，Cookie 是必须搞懂的东西。这篇用最简单的大白话解释清楚。

一、Cookie 是什么？

打个比方：

你去景区买票，售票员给你一张”入门卡”。你进每个项目时只要出示这张卡，工作人员就知道你买过票了。

Cookie 就是服务器的”入门卡”。

  • 登录成功后，服务器给你一个 Cookie（里面有一段特殊字符串，相当于”票根”）
  • 后续请求带上这个 Cookie，服务器就知道”哦，这是刚才登录过的那个用户”

JMeter 测试时，Cookie 管理这件事，由 HTTP Cookie Manager 来完成。

二、CookieManager 是什么？

JMeter 里的 HTTP Cookie Manager，就是专门管理 Cookie 的元件。

它的功能很简单：

  1. 自动存储服务器返回的 Cookie
  2. 自动带上后续请求的 Cookie
  3. 帮你决定 Cookie 什么时候清除、什么时候共享

就这么三件事，不用想复杂了。

三、界面怎么配置？

第一步：添加到测试计划

在 Thread Group（线程组）上右键：

Add → Config Element → HTTP Cookie Manager

就加好了，很简单。

第二步：看明白两个关键配置

界面上有两个容易让人困惑的选项，说人话解释：

选项作用怎么选
Clear cookies each iteration?每次循环时要不要清空Cookie单用户测试选 No，多用户轮询选 Yes
Controlled by Thread Group?每个线程是否用独立的Cookie单线程选 No，多线程选 Yes

最常用的简单配置：

  • 单用户功能测试：No + No
  • 多用户并发测试：No + Yes

就这两个组合，搞定80%的场景。

第三步：检查 Cookie 列表（可选）

Cookie Manager 下面有一块空白区域，运行测试后，这里会显示存储的 Cookie。

不用手动添加，JMeter 会自动管理。

补充：Cookie Manager 的位置与生效规则

这是很多人容易搞混的地方：位置决定作用域，不是顺序。

Cookie Manager 位置生效范围
Thread Group 最上面对 Group 内所有请求生效 ✓
登录请求之后只对登录之后的请求生效 ✓
Thread Group 最下面对 Group 内的请求不生效 ✗

为什么放在最后不生效？

JMeter 执行时，Config Element 的位置决定它对哪些请求起作用。如果 Cookie Manager 在请求列表的最后面，它前面没有任何请求，那它存储的 Cookie 没有请求可以用，等于白放。

正确姿势：把 Cookie Manager 放在线程组最上面（或登录请求之前），这样它能拦截到所有后续请求的 Cookie。

四、实际使用流程（看图说话）

假设你要测试一个”登录后查看首页”的功能：

第一步：准备登录请求

POST /api/login
Body: {"username":"test", "password":"123456"}

第二步：添加 Cookie Manager

位置：Thread Group 下面，登录请求的上面
配置：Clear each iteration = No
      Controlled by Thread Group = No

第三步：添加后续请求

GET /api/home
GET /api/userinfo
GET /api/notice

这些请求会自动使用登录时拿到的 Cookie。

完整结构长这样：

Test Plan
└── Thread Group (1线程)
    └── HTTP Cookie Manager  ← 加在这里
    └── 登录请求 (POST /api/login)
    └── 首页请求 (GET /api/home)
    └── 用户信息 (GET /api/userinfo)
    └── 通知列表 (GET /api/notice)

执行流程：

1. 线程组启动
       ↓
2. 执行登录请求 → 服务器返回 Cookie → CookieManager 自动存储
       ↓
3. 执行首页请求 → 自动带上 Cookie → 服务器识别为已登录用户
       ↓
4. 执行用户信息请求 → 同样自动带 Cookie
       ↓
5. 完成测试

全程不用你手动做任何事，CookieManager 自动搞定。

五、常见的坑和解决办法

坑1：登录成功了，后续请求还是失败

原因：Cookie Manager 没加，或者位置放错了

解决：确认 Cookie Manager 在线程组下面，且在登录请求之前

坑2：多用户测试时 Cookie 混乱

原因：所有线程共享了同一个 Cookie

解决：把 Controlled by Thread Group 改成 Yes

坑3：迭代测试时第二次请求就失败了

原因：Cookie 没清，导致重复登录出问题

解决：把 Clear each iteration 改成 Yes

六、一句话总结

Cookie 是服务器的”身份卡”，Cookie Manager 就是 JMeter 里帮你自动存取这张卡的东西。

记住：

  • 登录请求之前放 Cookie Manager
  • 后续请求不用管，JMeter 自动带
  • 调参数就调那两个选项，够了