3. OpenAPI 规范与压测适配：OpenAPI 3.0 规范核心结构、路径参数与请求体建模、压测脚本自动生成策略

3.1 OpenAPI 3.0 规范核心结构

OpenAPI 3.0 是业界标准的 RESTful API 描述规范，其核心结构围绕 路径（Paths）、组件（Components） 与 请求/响应模型 展开。在并发压测场景中，规范的核心价值在于：将接口定义从自然语言文档转化为机器可解析的契约，从而驱动压测脚本的自动生成与参数化建模。

OpenAPI 3.0 规范顶层包含以下关键字段：

3.2 路径参数与请求体建模

在并发压测中，路径参数与请求体是参数化建模的两个核心输入源。OpenAPI 3.0 通过 parameters 与 requestBody 字段精确描述了接口的输入契约，压测脚本生成器需要将其转化为可动态替换的模板变量。

3.2.1 路径参数建模

路径参数通常出现在 RESTful 资源路径中，例如 /users/{userId}。OpenAPI 3.0 中路径参数的定义包含以下关键属性：

3.2.2 请求体建模

对于 POST/PUT/PATCH 操作，requestBody 定义了请求负载的结构。OpenAPI 3.0 使用 content 字段描述不同媒体类型（如 application/json、application/x-www-form-urlencoded）下的 Schema 定义。

请求体建模的核心步骤：

1. 解析媒体类型： 优先使用 application/json，若不存在则回退到 multipart/form-data 或 application/x-www-form-urlencoded。
2. 递归遍历 Schema： 从 components/schemas 或内联 Schema 出发，提取所有字段的名称、类型、约束与嵌套结构。
3. 生成默认值/随机值： 根据字段类型（string/integer/boolean/array/object）生成符合 Schema 约束的测试数据。
4. 构造请求体模板： 将生成的测试数据序列化为 JSON 字符串或表单格式，作为压测脚本的请求体模板。

3.3 压测脚本自动生成策略

基于 OpenAPI 3.0 规范的压测脚本自动生成，核心目标是：将规范中的接口定义转化为可执行的并发压测代码。生成策略需要覆盖路径遍历、参数化、请求体构造、并发控制与结果收集五个维度。

3.3.1 路径遍历与场景映射

生成器遍历 paths 对象下的每个路径与 HTTP 方法，为每个 operation 生成一个独立的压测场景。场景命名规则建议为：{HTTP方法}_{路径标签}，例如 GET_users_id。

3.3.2 参数化模板引擎

压测脚本中的参数值不应是静态的，而应使用模板变量。生成器将路径参数、查询参数与请求体字段映射为模板变量，并在运行时由数据源（如 CSV 文件、随机生成器、递增计数器）填充。

// 自动生成的压测场景：GET /users/{userId}
func scenarioGetUsersId(ctx *k6.Context) {
    // 模板变量：userId 从数据源动态获取
    userId := ctx.VU.GetRandomInt(1, 100000)
    url := fmt.Sprintf("http://api.example.com/users/%d", userId)

    // 发起 GET 请求
    resp := ctx.HTTP.Get(url, nil)
    ctx.Check("status is 200", func() bool {
        return resp.StatusCode == 200
    })
}

3.3.3 并发控制与负载模型

自动生成的压测脚本需要支持可配置的并发模型。常见的并发策略包括：

• 固定虚拟用户（VU）： 指定并发数，每个 VU 持续发送请求，适用于稳态负载测试。
• 阶梯递增： 从低并发逐步增加到目标并发，用于观察系统性能拐点。
• 突发模式： 在短时间内快速增加并发，模拟流量尖峰。

生成器应在脚本中预留并发参数配置入口，例如通过环境变量或配置文件控制 VU_COUNT、DURATION、RAMP_UP 等参数。

3.3.4 结果收集与断言

压测脚本自动生成时，应内置结果收集逻辑：

1. 响应时间分位值： p50、p90、p99 延迟统计。
2. 错误率： 非 2xx/3xx 状态码的请求占比。
3. 吞吐量： 每秒请求数（RPS）。
4. 断言规则： 基于 OpenAPI 响应 Schema 自动生成状态码与响应体结构断言。

3.3.5 生成策略对比