Node.js后端API设计：5页客户数据插入关联表的API选型咨询

单个接口方案 #

• 实现思路：前端收集完5个页面的所有客户数据后，一次性通过POST请求提交到统一接口（例如/api/customers/create），后端在数据库事务中依次完成customer-master、addresstable、bankdetailstable、contacttable的插入操作，所有步骤成功才提交事务，任意一步失败则全部回滚。
• 优点：
  • 强数据一致性：事务机制从根本上避免了“部分表插入成功、部分失败”的脏数据问题。
  • 前后端交互简洁：前端无需在页面切换时频繁调用接口，仅需最后一次提交，减少网络开销。
  • 后端逻辑集中：所有关联数据的插入、校验逻辑集中在一处，便于维护和排查问题。
• 缺点：
  • 单次请求 payload 偏大：如果字段数量极多，请求体体积会相应增大，但现代HTTP协议和服务器对此都有成熟的支持，一般不会造成性能问题。
  • 前端需暂存多页数据：需要用localStorage、sessionStorage或者前端状态管理工具暂存各页面的输入内容，直到最终提交。

多个接口方案 #

• 实现思路：每个页面填写完成后，调用对应接口提交当前页面的数据。例如：
  • 基础信息页提交到/api/customers/basic，插入customer-master并返回主键ID；
  • 地址页提交到/api/customers/address，携带之前返回的主键ID插入addresstable；
  • 以此类推完成其他表的插入。
• 优点：
  • 分步保存提升用户体验：用户填完一页就能保存，避免因页面刷新、浏览器崩溃导致的全部数据丢失，适合长表单场景。
  • 请求粒度小：每次仅提交当前页面的字段，网络请求更轻量化。
• 缺点：
  • 数据一致性难保障：如果用户中途放弃填写，数据库中会留下不完整的客户数据，需要额外设计“草稿状态”（比如给customer-master加status字段标记draft/completed），或者提供数据回滚机制。
  • 后端逻辑分散：多个接口各自处理不同表的业务，需要维护更多路由和校验逻辑，跨表关联的校验会更复杂。
  • 前端状态管理成本高：需要妥善保存customer-master的主键ID，确保后续接口调用时能正确关联，增加了前端状态维护的复杂度。

选型建议 #

• 若业务要求客户数据必须完整才能正式入库（不允许存在不完整的客户记录），优先选择单个接口方案，配合前端本地暂存数据，后端用事务严格保障数据一致性。
• 若业务允许分步保存草稿，或者表单字段量极大导致单次提交的用户体验不佳，则选择多个接口方案，同时在数据库中增加状态字段区分草稿和正式数据，后续补全时更新对应表的内容。

内容的提问来源于stack exchange，提问作者Subhash S Kandakur