Node.js代码与Postman请求数据不一致问题排查及修正需求

咱们直接说核心问题：你的Node.js代码里请求头的Content-Type和实际发送的请求体格式不匹配，这就是服务器返回格式错误的根源，而Postman正确匹配了这两者，所以请求成功。

具体问题点 #

你设置的Content-Type是application/x-www-form-urlencoded，这种格式要求请求体是key1=value1&key2=value2这样的键值对字符串，但你实际传的是JSON格式的字符串，服务器拿到后按照urlencoded的规则去解析，自然会判定格式错误。

而Postman测试成功，大概率是因为你在Postman里选择了正确的请求体类型（比如Raw JSON），Postman自动帮你设置了对应的Content-Type: application/json；或者你在Postman里正确编码了urlencoded格式的数据。

两种修正方案（对应Postman的不同请求方式） #

方案一：如果Postman用的是Raw JSON格式（最常见情况） #

这种情况下，只需要把请求头改成application/json，并且利用request库的便捷参数处理JSON序列化细节，不用手动计算Content-Length（request会自动处理）。

修正后的代码：

var data = { 
  'Token' : 'cfe45090d19da5dbcc41a1f48c8cfd030e2af9d9', 
  'BrandId' : 2, 
  'Data': [{ 
    'Email': 'test@test.com', 
    'Name': 'test', 
    'Cphone': '5553338888' 
  }]
};

var req_options = { 
  uri: 'https://webAPI', 
  method: 'POST', 
  headers: { 'Content-Type': 'application/json' },
  body: data,
  json: true // 这个参数是关键：自动序列化body为JSON，设置正确的Content-Type，还能自动解析响应JSON
};

request(req_options, function (error, response, body) { 
  // 这里的body已经是解析后的JSON对象，直接用就行
  if (error) {
    console.error('请求出错:', error);
    return;
  }
  console.log('响应状态码:', response.statusCode);
  console.log('响应数据:', body);
});

方案二：如果Postman用的是x-www-form-urlencoded格式 #

这种情况下需要把你的JSON数据转换成符合urlencoded规范的字符串，尤其是Data数组这种嵌套结构，手动拼接容易出错，建议用qs库来处理（request库内置了这个库，也可以单独安装）。

修正后的代码：

var qs = require('qs'); // 如果你的request版本没内置，先执行npm install qs

var data = { 
  'Token' : 'cfe45090d19da5dbcc41a1f48c8cfd030e2af9d9', 
  'BrandId' : 2, 
  'Data': [{ 
    'Email': 'test@test.com', 
    'Name': 'test', 
    'Cphone': '5553338888' 
  }]
};

var formData = qs.stringify(data); // 正确处理嵌套对象和数组，生成urlencoded格式字符串

var req_options = { 
  uri: 'https://webAPI', 
  method: 'POST', 
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: formData
};

request(req_options, function (error, response, body) { 
  // 响应处理逻辑
  if (error) {
    console.error('请求出错:', error);
    return;
  }
  console.log('响应状态码:', response.statusCode);
  console.log('响应数据:', body);
});

验证小技巧 #

你可以打开Postman的请求详情，切换到Headers和Body标签，确认Postman实际发送的Content-Type和请求体格式，然后对应调整Node.js代码。另外Postman的Code功能（在请求右上角）可以直接生成Node.js（request库）的代码，对比一下就能快速找到差异。

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