批量GraphQL突变部分失败时，响应格式该选标准errors还是自定义节点？

在处理批量操作（比如批量删除）时，部分数据处理失败属于业务预期内的结果，而非请求级别的异常，因此更推荐使用data节点内创建单独的错误/失败节点（即示例2的方案），原因如下：

• 符合GraphQL错误语义：顶层errors节点的设计初衷是处理请求级别的错误，比如查询语法错误、全局权限不足、服务器内部崩溃等会导致请求无法正常执行的情况。而批量操作中部分数据失败是业务逻辑的一部分，不属于请求本身的异常，放在顶层errors会混淆错误类型，让客户端误解整个请求失败。

• 避免客户端处理异常：很多GraphQL客户端库（比如Apollo Client、Relay）在检测到顶层errors时，会默认抛出异常或标记整个请求为失败，可能会忽略data中返回的成功结果，导致客户端无法正确获取已成功处理的数据。

• 结构清晰易维护：将成功数据和失败信息封装在操作对应的返回结构中（比如deleteRecords下的data和errors），客户端可以直接通过操作结果获取完整的执行状态，逻辑更直观，也便于后续扩展失败信息的字段。

对比示例1的方案，用顶层errors会导致：

• 客户端难以区分是请求整体失败还是部分业务失败
• 可能触发客户端的错误拦截逻辑，丢失成功数据
• 不符合GraphQL官方对顶层错误的定义

因此，正确的做法是像示例2那样，在data内的操作返回结构中同时包含成功列表和失败列表，顶层errors仅用于处理真正的请求级异常。

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