Bruno脚本实战技巧：轻松获取原始请求体的3大方法-编程实验室

在API测试的世界里，你是否曾经遇到过这样的困惑：明明发送的数据是完整的，为什么服务器接收到的却是另一番模样？🤔 特别是在处理加密接口、数据签名验证等高级场景时，获取原始请求体（Raw Request Body）成为了API测试人员必须掌握的技能。今天，就让我手把手教你如何在Bruno这个轻量级API测试工具中，轻松获取原始请求体，让你的API测试更加精准可靠！

【免费下载链接】bruno开源的API探索与测试集成开发环境（作为Postman/Insomnia的轻量级替代方案）项目地址: https://gitcode.com/GitHub_Trending/br/bruno

为什么你需要原始请求体？

在开始之前，我们先来搞清楚一个问题：为什么request.body和实际发送的数据不一致？这是因为Bruno会根据Content-Type自动解析请求体，比如JSON类型会被解析为对象。但在某些场景下，我们需要的是最原始的数据：

加密接口：需要对原始数据进行哈希计算或加密
签名验证：银行、支付等敏感API的数据完整性验证
格式检查：验证XML、FormData等非JSON格式的数据
调试需求：对比发送数据和接收数据的一致性

方法一：getBody()方法的raw参数技巧

这是最官方、最推荐的方法！在Bruno的核心请求处理类中，getBody()方法专门提供了raw选项：

// 请求前脚本示例 - 获取原始请求体 function onRequest(request) { // 使用raw参数获取未经解析的原始数据 const rawBody = request.getBody({ raw: true }); console.log('原始请求体内容:', rawBody); // 实战应用：数据签名 const signature = generateSignature(rawBody); request.setHeader('X-Signature', signature); }

💡 小贴士

当raw设置为true时，返回的是字符串格式的原始数据
适用于所有类型的请求体，包括JSON、XML、文本等
这是官方文档推荐的标准做法

方法二：直接访问req.data属性

如果你想要更直接的方式，可以直接访问请求对象的req.data属性。这个属性始终存储着最原始的请求数据：

// 完整请求脚本示例 function onRequest(request) { // 直接获取原始请求体 const rawData = request.req.data; console.log('最原始的数据:', rawData); // 高级用法：动态修改请求体 const processedData = rawData.replace('{{username}}', 'test_user'); request.setBody(processedData, { raw: true }); }

⚠️ 注意事项

req.data是内部属性，未来版本可能变更
修改数据时一定要使用setBody()方法，不要直接赋值
建议优先使用getBody({raw: true})方法

方法三：响应处理中的回溯技巧

有时候，我们需要在收到响应后验证发送的数据是否正确。这时候可以通过请求对象回溯原始请求体：

// 响应处理脚本示例 function onResponse(request, response) { // 获取发送的原始请求体 const sentData = request.req.data; // 获取服务器返回的请求快照 const receivedData = response.json().requestSnapshot; // 数据一致性验证 expect(sentData).to.equal(receivedData); // 保存原始请求到环境变量 env.set('lastRequestRaw', sentData, { persist: true }); }

实战演练：XML接口测试

让我们来看一个具体的例子，处理XML格式的API请求：

<!-- 请求体模板 --> <xml> <user>{{username}}</user> <data>{{rawData}}</data> </xml>

// 对应的Bruno脚本 function onRequest(request) { // 获取原始XML数据 const rawXml = request.getBody({ raw: true }); // 替换模板变量 const finalXml = rawXml .replace('{{username}}', 'test_user') .replace('{{rawData}}', 'encrypted_data_here'); // 重新设置请求体 request.setBody(finalXml, { raw: true }); }

高手进阶：批量处理与自动化

集合测试中的批量获取

在大型项目中，你可能需要批量获取多个请求的原始数据：

// 使用Bruno CLI生成测试报告 // bruno run --reporter json

生成的报告文件中包含了每个请求的详细原始数据，便于后续分析。

环境变量与模板管理

你可以通过多行环境变量来存储请求体模板：

// 读取模板并设置请求体 const template = env.get('xmlTemplate'); const processedTemplate = template .replace('{{timestamp}}', new Date().getTime()); request.setBody(processedTemplate, { raw: true });

最佳实践总结

场景	推荐方法	注意事项
常规使用	`getBody({raw: true})`	官方标准，兼容性好
快速调试	`req.data`	仅用于读取，不要修改
批量处理	CLI报告功能	适合CI/CD流程
模板化请求	环境变量+setBody	支持动态数据替换