REST API设计：如何将多个POST/PUT请求打包为同一事务处理？

针对你遇到的问题，有几种通用方案可以实现客户端单次调用完成多操作且保证事务性，同时满足SQL Server系统版本表的单一事件需求：

1. 新增批量操作端点 #

专门设计一个支持复合操作的端点，比如 PATCH /customers/{id}/batch，接收包含多个操作指令的请求体。示例请求体结构如下：

{
  "operations": [
    {"type": "update_customer", "data": {"name": "张三", "email": "zhangsan@example.com"}},
    {"type": "add_telephone", "data": {"number": "138xxxx1234", "type": "mobile"}},
    {"type": "remove_address", "data": {"addressId": 101}},
    {"type": "update_address", "data": {"addressId": 102, "detail": "XX街道XX号"}}
  ]
}

后端接收到请求后，开启一个数据库事务，按顺序执行所有操作指令，只有全部执行成功才提交事务，任意步骤失败则回滚。这种方式下，SQL Server系统版本表只会生成一条对应整个事务的时间线记录。

2. 扩展PATCH请求支持复合修改 #

遵循RFC 6902（JSON Patch）规范，或者自定义补丁格式，允许在单个PATCH请求中同时修改主客户字段和子对象。示例JSON Patch请求体：

[
  {"op": "replace", "path": "/name", "value": "张三"},
  {"op": "add", "path": "/telephones/-", "value": {"number": "138xxxx1234", "type": "mobile"}},
  {"op": "remove", "path": "/addresses/0"},
  {"op": "replace", "path": "/addresses/1/detail", "value": "XX街道XX号"}
]

后端在处理这个PATCH请求时，将所有修改逻辑放在同一事务中执行，确保所有变更作为单一事件被系统版本表记录。

3. 通用批量请求端点 #

实现一个全局的批量处理端点，比如 POST /batch，允许客户端提交一组API请求的集合，后端在同一事务中按顺序执行这些请求。示例请求体：

{
  "requests": [
    {"method": "PATCH", "path": "/customers/123", "body": {"name": "张三"}},
    {"method": "POST", "path": "/customers/123/telephones", "body": {"number": "138xxxx1234", "type": "mobile"}},
    {"method": "DELETE", "path": "/customers/123/addresses/101"}
  ]
}

这种方案的优势是无需为每个资源单独设计批量端点，复用现有API逻辑即可，但需要注意处理请求的幂等性、超时控制和错误回滚机制。

关键注意事项 #

• 事务边界：所有操作必须严格在同一个数据库事务内执行，确保要么全部成功，要么全部回滚。
• 幂等性：批量操作的每个步骤都要保证幂等，避免重复提交导致数据异常。
• 错误反馈：需要向客户端返回清晰的错误信息，说明哪个操作失败以及失败原因。

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