如何使用Karate测试携带请求体的GET请求并解决400报错问题

问题根因 #

• 标准HTTP规范中未定义GET请求携带请求体的使用语义，绝大部分服务端框架、反向代理服务默认会丢弃GET请求的body payload，这是触发400报错的核心原因
• 你遇到的expected JSONArray and found Null报错，本质是服务端未收到你传入的请求体内容，解析时拿到空值触发了类型校验失败

Karate端正确配置 #

Karate默认使用get关键字发送请求时不会携带请求体，需要按如下规则配置：

1. 1.0及以上版本Karate #

不要用默认的get路径简写写法，手动指定请求方法+传入请求体即可，示例如下：

Feature: 带请求体GET接口测试

Scenario: 发送携带JSON请求体的GET请求
  * url 'https://你的目标接口地址'
  * header Content-Type = 'application/json'
  # 定义请求体内容
  * request {
      "query": "test",
      "filter": ["条件1", "条件2"]
    }
  # 手动指定用GET方法发送，会自动携带上面定义的request
  * method 'get'
  # 响应校验
  * status 200
  * match response.arrayField != null

2. 0.9.x及更早版本Karate #

需要先在karate-config.js中开启GET请求带body的配置：

function fn() {
  var config = {
    // 其他配置项
  };
  karate.configure('http', { allowGetBody: true });
  return config;
}

开启配置后，再按上面的示例写法发送请求即可。

异常排查方案 #

如果配置完成后仍然报错，按如下步骤排查：

• 代码中添加* karate.log('发送的请求体:', request)确认请求体内容是否符合服务端要求
• 用抓包工具确认Karate是否真的将请求体发出，排除Karate配置问题
• 确认服务端侧是否支持解析GET请求的请求体：比如SpringBoot默认不支持GET接口接收@RequestBody参数，Nginx反向代理默认会丢弃GET请求的body，都需要单独调整配置支持。

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