如何在Express REST API中接收大表单并简化多字段传输结构

1. 传输层优化 #

首先替换当前的x-www-form-urlencoded传输格式，改为application/json格式：

• 该格式原生支持嵌套结构、数组类型，完全适配多字段的表单提交场景，不需要通过字段后缀区分同类型数据
• Express侧只需要注册内置的express.json()中间件，即可直接从req.body获取解析完成的JS对象，不需要额外处理表单解析逻辑
• 前端React侧提交时直接序列化表单状态对象即可，不需要手动拼接几十个表单键值对

2. 字段结构化聚合 #

按照业务属性把零散的平级字段聚合为嵌套结构，直接把几十个平级字段压缩为少量顶级键值对，参考你给出的字段示例，可按如下方式聚合：

{
  "userBaseInfo": {
    "name": "张三",
    "surname": "李四",
    "someOtherField": "xxx",
    "otherField": "xxx"
  },
  "locations": [
    {
      "name": "办公地点",
      "address": "XX路XX号",
      "latitude": 31.23,
      "longitude": 121.47
    },
    {
      "name": "居住地点",
      "address": "YY路YY号",
      "latitude": 31.25,
      "longitude": 121.49
    }
  ]
}

这种结构下：

• 所有带_1/_2后缀的位置字段被整合为locations数组，彻底消除了重复的字段名前缀、后缀
• 同属性的字段聚合后，前端可以按模块做表单状态管理，后端也可以按模块做参数校验、业务处理，不需要维护几十条零散的字段映射

3. 可参考的设计模式 #

• 数据传输对象（DTO）模式：前后端统一约定请求、响应的结构化格式，所有接口的入参、出参都严格按照DTO定义实现，避免零散字段的随意传递，同时可以基于DTO做统一的参数校验、类型检查。
• 值对象（Value Object）模式：把位置信息这类有固定属性组合的字段封装为独立的值对象，前端可以封装对应的表单组件、校验逻辑，后端可以封装对应的入库、查询逻辑，大幅减少重复代码，也能避免字段名拼写错误这类低级问题。
• 外观模式：如果现有后端业务逻辑已经基于平级字段开发完成，不需要重构原有业务代码，只需要新增一层转换逻辑：收到结构化请求后拆解为原有逻辑需要的平级字段，返回数据时把平级的查询结果组装为结构化对象返回给前端，对原有业务的侵入性极低。

4. 额外优化建议 #

如果存在大量可选字段，可以前后端约定缺省规则，未传递的字段自动取预设默认值，进一步减少传输的内容体积。如果不同场景需要的返回字段不同，可以增加字段剪裁能力，前端请求时指定需要的字段列表，后端只返回对应字段，避免全量50个字段的冗余传输。

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