4. HTTP 请求与参数化：核心方法与响应解析

在 k6 容量压测中，HTTP 请求是脚本与目标系统交互的唯一通道。本章将系统讲解 http.get() 与 http.post() 的完整参数结构，以及如何通过参数化实现动态请求负载。掌握这些内容后，你将能够构造任意复杂度的 HTTP 请求，并准确解析响应数据用于断言与巡检。

4.1 HTTP 请求方法速览

k6 内置的 http 模块提供了所有标准 HTTP 方法。在容量压测巡检场景中，最常用的是 GET 和 POST，但 PUT、PATCH、DELETE 等方法的参数结构完全一致。

4.2 参数对象（params）详解

params 是 k6 HTTP 请求的核心配置容器，支持 headers、tags、cookies、auth 等 10+ 属性。以下是最常用的配置项：

4.3 响应对象结构

每个 HTTP 请求都会返回一个 http.Response 对象，包含完整的响应信息。理解其结构是编写断言和提取数据的基础。

// 响应对象核心属性
let res = http.get('https://api.example.com/users');

// 状态码
console.log(res.status);           // 200

// 响应体（字符串）
console.log(res.body);             // '{"users":[...]}'

// 响应头
console.log(res.headers['Content-Type']);  // 'application/json'

// 响应时间（毫秒）
console.log(res.timings.duration); // 123.45

// JSON 解析
let jsonData = res.json();
console.log(jsonData.users[0].name);

// 检查响应是否成功
check(res, {
  'status is 200': (r) => r.status === 200,
  'response time < 500ms': (r) => r.timings.duration < 500
});

4.4 参数化实战：动态请求构造

容量压测的核心在于参数化——每次迭代使用不同的数据，避免缓存命中导致测试失真。以下展示三种常用参数化模式：

4.4.1 从数组轮询参数

import http from 'k6/http';
import { check } from 'k6';

// 参数化数据源
const userIds = ['u001', 'u002', 'u003', 'u004', 'u005'];
const tokens = ['tok_a', 'tok_b', 'tok_c', 'tok_d', 'tok_e'];

export default function () {
  // 使用 __VU 和 __ITER 组合实现轮询
  let idx = (__VU + __ITER) % userIds.length;
  
  let params = {
    headers: {
      'Authorization': `Bearer ${tokens[idx]}`,
      'Content-Type': 'application/json'
    },
    tags: { user: userIds[idx] }
  };

  let res = http.get(`https://api.example.com/users/${userIds[idx]}`, params);

  check(res, {
    'user query success': (r) => r.status === 200,
    'response time < 300ms': (r) => r.timings.duration < 300
  });
}

4.4.2 POST 请求带 JSON Body

import http from 'k6/http';
import { check } from 'k6';

const payloads = [
  { username: 'alice', role: 'admin' },
  { username: 'bob', role: 'editor' },
  { username: 'charlie', role: 'viewer' }
];

export default function () {
  let idx = __ITER % payloads.length;
  let body = JSON.stringify(payloads[idx]);

  let params = {
    headers: { 'Content-Type': 'application/json' },
    tags: { payload_idx: String(idx) }
  };

  let res = http.post('https://api.example.com/users', body, params);

  check(res, {
    'user created': (r) => r.status === 201,
    'has user id': (r) => r.json().id !== undefined
  });
}

4.4.3 动态查询参数

import http from 'k6/http';

const searchTerms = ['k6', 'load testing', 'performance'];

export default function () {
  let q = searchTerms[__ITER % searchTerms.length];
  
  let res = http.get('https://api.example.com/search', {
    params: { q: q, page: '1', limit: '20' },
    headers: { 'Accept': 'application/json' }
  });

  console.log(`Search for "${q}" returned ${res.json().total} results`);
}

4.5 HTTP 请求与响应流程

下图展示了从参数构造到响应解析的完整数据流，帮助理解各环节的协作关系：

4.6 完整实战示例：用户登录巡检

以下脚本综合运用了 POST 请求、参数化、响应解析和断言，模拟多用户登录巡检场景：

import http from 'k6/http';
import { check, sleep } from 'k6';

// 参数化用户数据
const users = [
  { email: 'alice@test.com', password: 'pass123' },
  { email: 'bob@test.com', password: 'pass456' },
  { email: 'charlie@test.com', password: 'pass789' }
];

export default function () {
  // 轮询用户
  let user = users[__ITER % users.length];

  // 构造请求
  let payload = JSON.stringify({
    email: user.email,
    password: user.password
  });

  let params = {
    headers: { 'Content-Type': 'application/json' },
    tags: { user_email: user.email }
  };

  // 发送登录请求
  let res = http.post('https://api.example.com/login', payload, params);

  // 响应断言
  check(res, {
    'login success': (r) => r.status === 200,
    'has ': (r) => r.json(). !== undefined,
    'response fast': (r) => r.timings.duration < 1000
  });

  // 提取  用于后续请求（可选）
  if (res.status === 200) {
    let  = res.json().;
    // 后续请求可使用此 
  }

  sleep(1);
}

4.7 常见错误与排查