Pactum Cucumber出现Undefined错误求助：Postman请求正常测试失败

核心排查方向与解决方案 #

1. 确认请求是否完成并返回有效响应 #

首先排查请求本身是否成功执行：

• 在Then步骤开头添加状态码检查与完整响应打印，确认API返回状态：

  Then('the API should respond with a 6-digit numeric OTP and a transaction key', () => {
      console.log('Response Status:', spec.response.statusCode);
      console.log('Full Response:', spec.response);
      // 先断言状态码正常
      expect(spec.response.statusCode).to.equal(200);
      // 后续原有断言逻辑...
  });
  

• 如果状态码为4xx/5xx，说明请求本身失败，API返回的是错误结构，自然无法读取otp等属性，此时需检查请求参数、权限是否与Postman完全一致。

2. 检查响应是否被正确解析为JSON对象 #

若spec.response.body是字符串而非JSON对象，直接访问属性会抛出undefined错误：

• 打印响应体类型确认：

  console.log('Body Type:', typeof spec.response.body);
  

• 如果是字符串，手动解析后再访问属性：

  const body = JSON.parse(spec.response.body);
  otp = body.otp;
  TransactionId = body.transaction_id;
  

• 同时检查API响应头的Content-Type是否为application/json，非该类型时Pactum可能不会自动解析响应。

3. 验证请求配置与Postman完全一致 #

即使已核对配置，仍需重点检查以下细节：

• 请求方法（GET/POST/PUT等）是否与Postman一致；
• 请求头：尤其是Authorization、Content-Type、Accept等关键头，是否有遗漏或拼写错误；
• 请求参数：query参数、body参数的键名、值是否完全匹配，注意大小写差异；
• 用抓包工具（如Charles、Fiddler）对比Pactum和Postman的请求报文，确保两者完全一致。

4. 排查异步执行与变量作用域问题 #

• 异步问题：发送请求的When步骤若为异步操作，必须确保请求完成后再进入断言步骤，需添加async/await：

  When('I send the OTP request', async () => {
    spec = await pactum.spec().post('/api/otp').withBody({ /* 请求体内容 */ });
  });
  

• 变量作用域：确保spec变量在步骤间可共享，比如挂载到Cucumber的World对象中，避免局部变量导致spec未赋值：

  // 在World定义中添加
  this.spec = null;
  
  // When步骤中
  When('I send the OTP request', async function () {
    this.spec = await pactum.spec().post('/api/otp').withBody({...});
  });
  
  // Then步骤中
  Then('the API should respond with...', function () {
    const body = this.spec.response.body;
    // 断言逻辑...
  });
  

5. 检查响应属性名是否匹配 #

仔细对比Postman返回的响应结构，确认属性名与代码中的完全一致：

• 比如Postman返回transactionId（驼峰），但代码中用了transaction_id（下划线），会导致属性读取undefined；
• 打印完整的spec.response.body，逐行核对属性名拼写、大小写。

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