如何在Karate框架中获取并存储API完整原始请求（含请求头）为字符串？

当然可以！Karate框架其实提供了几种灵活的方式来捕获包含所有请求头的完整原始API请求，并且把它存储为字符串变量，下面给你介绍几个实用的方案：

方法1：直接转换请求对象为原始字符串 #

在发送请求的场景中，你可以利用Karate内置的karate.toRequestString()函数，把当前的请求对象直接转换成标准的HTTP请求格式字符串。示例如下：

Given url 'https://api.example.com/your-endpoint'
And header Content-Type = 'application/json'
And header Authorization = 'Bearer your-token'
And request { id: 123, name: 'test' }
# 将请求对象转换为原始HTTP字符串并存储到变量
* def rawFullRequest = karate.toRequestString(request)
When method post
Then status 200

# 可以打印验证或者后续使用这个变量
* print '完整原始请求:', rawFullRequest

这个方法生成的字符串会包含完整的请求行、所有请求头以及请求体，格式类似这样：

POST /your-endpoint HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer your-token
Content-Length: 27

{"id":123,"name":"test"}

方法2：用请求钩子全局捕获请求 #

如果需要在多个场景中统一捕获请求，或者要捕获Karate自动添加的默认请求头（比如Host、User-Agent），可以通过configure beforeRequest钩子来实现，在请求发送前自动捕获并存储原始请求：

# 配置全局请求钩子，每次请求前执行
* configure beforeRequest = function(req) {
    # 转换请求为原始字符串并存储到全局变量
    var rawRequest = karate.toRequestString(req);
    karate.set('globalRawRequest', rawRequest);
    # 可选：直接写入文件保存
    karate.write(rawRequest, 'api-requests/raw-request-' + karate.uuid() + '.txt');
}

# 发起API请求
Given url 'https://api.example.com/another-endpoint'
And request { param: 'value' }
When method get
Then status 200

# 使用存储的原始请求变量
* print '全局捕获的原始请求:', globalRawRequest

方法3：封装为可复用的函数 #

如果需要在多个测试用例中重复生成原始请求字符串，可以把逻辑封装成函数，方便调用和共享：

# 定义生成原始请求的函数
* def buildRawRequest = function(reqDetails) {
    # reqDetails需要包含method、url、headers、body等字段
    return karate.toRequestString(reqDetails);
}

# 调用函数生成并存储原始请求
* def sharedRawRequest = callSingle(buildRawRequest, {
    method: 'PUT',
    url: 'https://api.example.com/update',
    headers: { 'Content-Type': 'application/json' },
    body: { status: 'active' }
})

# 后续场景中直接使用这个变量
* print '复用的原始请求:', sharedRawRequest

需要注意的是，karate.toRequestString()会自动处理不同类型的请求体（比如JSON、form-data、xml等），确保生成的原始请求和实际发送的请求完全一致。

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