如何仅用Node.js的https包发送URL编码的POST请求

要仅用Node.js内置的https包发送符合application/x-www-form-urlencoded格式的POST请求，可按以下方式实现：

核心要点说明 #

• 配置请求参数：指定请求的主机、路径、方法，必须在请求头中设置Content-Type为application/x-www-form-urlencoded，确保服务端能正确解析请求体。
• 处理响应结果：监听响应的data事件拼接返回内容，响应结束后可对完整数据进行处理。
• 编码请求体：利用Node.js内置的URLSearchParams将对象数据自动转为URL编码格式，无需额外工具。
• 发送并结束请求：通过req.write()写入编码后的请求体，最后调用req.end()完成请求流程。

完整示例代码 #

const https = require('https');

// 待发送的原始数据
const data = {
  username: 'testUser',
  password: 'testPass123'
};

const options = {
  hostname: "myTestURL.com",
  port: 443,
  path: '/foo',
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
    // 可选：部分服务端要求Content-Length头，可通过此方式设置
    // 'Content-Length': new URLSearchParams(data).toString().length
  },
}

let response = '';
const req = https.request(options, (res) => {
  // 分段拼接响应数据
  res.on('data', (d) => {
    response += d;
  });

  // 响应完成后处理结果
  res.on('end', () => {
    console.log('响应内容:', response);
  });
});

// 捕获请求过程中的错误
req.on('error', (e) => {
  console.error('请求出错:', e);
});

// 写入URL编码后的请求体
req.write(new URLSearchParams(data).toString());
req.end();

关键细节提示 #

• URLSearchParams是Node.js原生API，能自动处理特殊字符的编码，避免手动拼接出现格式错误。
• 若服务端严格校验请求头，建议添加Content-Length字段，值为编码后请求体的字符串长度。
• 必须监听error事件，防止网络异常导致程序无提示崩溃。

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