Python requests库单元素数组请求NodeJS服务器丢失[]问题咨询

这是Python requests库的表单编码行为和Node.js端body解析器配置共同导致的典型跨语言数据传输问题：

• requests的默认编码逻辑：当你用data参数发送表单数据（application/x-www-form-urlencoded格式）时，若数组只有一个元素，requests会自动将其简化为单个键值对（比如inputs=xxx），不会保留数组的[]标识；只有当数组包含多个元素时，它才会生成inputs[]=val1&inputs[]=val2的格式，Node.js端才能识别为数组。
• Node.js body-parser的默认规则：如果你的服务器用的是body-parser的urlencoded解析器，默认extended: false的情况下，只有带[]后缀的参数会被解析为数组，否则单个值会被当作普通字符串处理，自然就丢失了数组的方括号结构。

这里有几个靠谱的解决办法，按推荐度排序：

1. 发送JSON格式请求（最推荐） #

直接用requests的json参数传递数据，它会自动设置Content-Type: application/json请求头，Node.js端只要配置了JSON解析器，就能完美解析任何长度的数组：

Python端代码： #

import requests

# 不管是单元素还是多元素数组，都能正确传递
payload = {"inputs": [_file["_id"]]}
response = requests.post(your_server_url, json=payload)

Node.js端配置： #

确保你已经启用了JSON格式的请求体解析：

const bodyParser = require('body-parser');
app.use(bodyParser.json()); // 解析JSON请求体

2. 手动构造表单数组格式 #

如果必须使用application/x-www-form-urlencoded格式，你需要手动给键名加上[]后缀，告诉requests和Node.js这是一个数组：

Python端代码： #

import requests

payload = {"inputs[]": [_file["_id"]]}
response = requests.post(your_server_url, data=payload)

这样requests会生成inputs[]=5a9be342dacc495d6a2ea8c0的请求体，Node.js的body-parser会自动把它解析为数组。

3. 修改Node.js端解析器配置（不推荐，仅当无法修改Python代码时使用） #

调整body-parser的extended选项为true，并配置qs库强制将指定参数解析为数组：

const bodyParser = require('body-parser');
app.use(bodyParser.urlencoded({
  extended: true,
  qsOptions: {
    parseArrays: true,
    // 可选：强制将inputs参数解析为数组
    decoder: (str, decoder, charset) => {
      if (typeof str === 'string' && str.startsWith('inputs=')) {
        return [decoder(str.split('=')[1], charset)];
      }
      return decoder(str, charset);
    }
  }
}));

不过这种方式灵活性差，不如直接用JSON格式来得稳妥。

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