API响应中使用内部引用避免数据重复是否属于不良实践？

结论 #

这个方案完全不属于不良实践，反而是当前限制下的最优解决方案之一，同类型场景下已经被业内广泛使用。

核心优势 #

• 收益直观：按你给出的场景规模测算，优化后响应体体积可以降低60%~80%，既节省带宽占用，同时前后端序列化/反序列化的CPU开销也会同步下降，接口响应速度会有明显提升。
• 避免数据不一致：原来的重复结构如果后续需要修改某个offer的字段，很容易出现漏改、不同分类下的相同offer数据不一致的问题，优化后所有offer只保留唯一数据源，完全规避了这个风险。
• 客户端适配成本极低：客户端只需要在拿到响应后做一次简单的映射即可还原为原有结构，参考代码如下：

// 前端数据还原示例
const offerMap = {}
res.data.catalog.offers.forEach(offer => {
  offerMap[offer.id] = offer
})
// 给分类填充完整offer数据
const categoriesWithOffer = res.data.catalog.categories.map(category => {
  return {
    ...category,
    offers: category.idOffers.map(id => offerMap[id])
  }
})

全程只需要十几行代码，几乎没有额外的开发负担。

可选优化建议 #

你可以根据业务需求调整细节：

• 如果不需要强制保持offer的全局排序，可以把offers从数组改为对象结构，key直接对应offer的id，客户端取值时不需要遍历构建映射表，直接取对应key即可，性能更高：

"offers": {
    "offer1": {
        "id": "offer1" // 其他字段
    },
    // 其他offer
}

• 接口文档中明确标注idOffers和offers的关联逻辑即可，避免后续对接人员误解字段含义。
• 服务端返回前可增加简单校验：确保所有出现在idOffers中的id都在offers中存在，避免无效引用。

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