Karate-Gatling：JSON Feeder嵌套JSON转Scala Map无法在.feature文件使用

核心问题原因 #

读取JSON文件后，嵌套的headers、body被解析为Scala的Map类型，但Gatling的Gherkin DSL（.feature文件）对复杂类型的直接支持有限，需要将这些结构转换为Gatling能识别的格式。

解决方案 #

方法一：预处理JSON数据，将嵌套结构转为Gatling兼容格式 #

在Scala读取JSON的阶段，把body转成JSON字符串，headers保持Map[String, String]（Gatling原生支持该类型作为请求头），再传递给.feature文件。

1. 定义数据模型与解析器

import com.fasterxml.jackson.databind.ObjectMapper
import com.fasterxml.jackson.module.scala.DefaultScalaModule
import java.io.File

// 定义API请求的结构
case class ApiTestConfig(
  url: String,
  method: String,
  headers: Map[String, String],
  body: Map[String, Any],
  status: Int
)

// 初始化Jackson解析器，支持Scala类型
val objectMapper = new ObjectMapper().registerModule(DefaultScalaModule)

2. 读取并预处理JSON文件

// 读取JSON文件并解析为List[ApiTestConfig]
val rawConfigs = objectMapper.readValue[List[ApiTestConfig]](new File("api-tests.json"))

// 预处理：将body的Map转为JSON字符串
val processedConfigs = rawConfigs.map(config => {
  val bodyJson = objectMapper.writeValueAsString(config.body)
  config.copy(body = bodyJson) // 此时body类型变为String
})

3. 在.feature文件中直接引用
   此时body是JSON字符串，headers是Gatling支持的Map类型，可直接使用：

Scenario: Api Test
  Given url __gatling.url
  And headers __gatling.headers
  And request __gatling.body
  When method __gatling.method
  Then assert responseStatus == __gatling.status

方法二：使用Gatling Feeder批量处理请求 #

如果需要批量执行多个API测试，将JSON数组转为Gatling Feeder，自动为每个请求注入参数，同时处理类型转换。

1. 构建Feeder

// 读取JSON为Map列表，预处理body为JSON字符串
val apiFeeder = objectMapper.readValue[List[Map[String, Any]]](new File("api-tests.json"))
  .map(data => {
    val bodyJson = objectMapper.writeValueAsString(data("body"))
    data + ("body" -> bodyJson)
  })
  .iterator

2. 在Scala运行器中关联Feeder与场景

import io.gatling.core.Predef._
import io.gatling.http.Predef._

val testScenario = scenario("Batch API Test")
  .feed(apiFeeder) // 每次迭代从Feeder取一组参数
  .exec(http("API Request")
    .request("#{method}", "#{url}")
    .headers("#{headers}")
    .body(StringBody("#{body}"))
    .check(status.is("#{status}")))

// 配置测试并执行
setUp(testScenario.inject(atOnceUsers(1)))
  .protocols(http.baseUrl("https://springboot.app.com"))

关键注意点 #

• headers字段必须是Map[String, String]类型，确保JSON中的headers值都是字符串，避免解析为其他类型。
• body转为JSON字符串后，Gatling的request方法可直接识别，无需额外处理。
• 如果使用Gatling的Gherkin DSL，确保传递给.feature的参数类型与DSL要求匹配：字符串类型用于URL、请求体，Map类型用于请求头，整数用于状态码。

内容的提问来源于stack exchange，提问作者Mridul Tripathi