NodeJS请求返回Map类型数据的可行性与序列化为空的问题排查

你遇到的现象本质和NodeJS的接口返回逻辑无关，核心原因是：res.json() 是靠环境内置的 JSON.stringify() 完成数据序列化的，而原生JSON序列化逻辑从设计上就不支持Map、Set这类ES6推出的内置集合类型。
Map实例的键值对是存在内部专用的内存槽位里的，不属于普通对象的可枚举自有属性。当序列化逻辑遍历对象可枚举字段时，完全识别不到Map里存的内容，最终就会输出空的{}。你在返回前用console.log能看到Map里有完整数据，是因为Node.js的控制台对Map实例做了特殊的格式化渲染，不代表这些数据能被JSON序列化流程识别。

• 最省事的局部改造：返回前手动把Map转成普通对象
  不用改动原有组装数据的业务逻辑，只要在调用res.json()前加一行转换代码就行：

  // 原有组装returnData的逻辑跑完后
  // 把Map结构转成普通可序列化对象
  returnData.details = Object.fromEntries(returnData.details)
  return res.json(returnData)
  

  Object.fromEntries() 是JS原生提供的方法，专门用来把Map、带键值对的二维数组转成普通对象，能完整保留所有存储的内容，转换成本极低。
• 全局适配方案：自定义Map的序列化规则
  如果项目里多个接口都需要返回Map结构，不想在每处都手动转换，可以给Map原型加自定义的toJSON方法，让所有Map实例在参与序列化时自动完成转换：

  // 注意：这个操作会全局修改所有Map实例的序列化行为，要评估好影响范围再用
  Map.prototype.toJSON = function() {
    return Object.fromEntries(this)
  }
  

  配置完成后不需要再在每个接口返回前手动处理Map结构，序列化流程会自动识别Map的内容完成输出。
• 前端兼容方案：如果业务场景要求键必须保留数字类型的语义（普通对象的键本质都是字符串，会丢失原有的数字类型标记），可以把Map转成由[key, value]组成的二维数组返回，前端拿到数据后自行重组为Map实例使用。

额外提一个可优化的点：你现在的代码在for循环里每次都串行调用数据库查询，会让接口响应时间随数据量线性拉长。可以提前收集所有需要查询的CheckRegisterID集合，并行发起数据库查询，拿到结果后再组装描述字符串，能明显降低接口的响应耗时。

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