调用ASP.NET Core 5 Web API POST接口同时增改时报HttpErrorResponse错误

问题描述 #

我尝试通过单个POST请求同时执行数据更新与插入操作，但接口返回HttpErrorResponse错误：Http failure response for api url。

可用于排查的相关材料 #

• 接口请求错误截图
• ASP.NET Core 5.0 Web API接口实现代码
• 业务服务层实现代码
• 前端接口调用函数代码
• 前端数据模型定义代码
• 后端C#接收参数模型定义代码
• 前端请求传递的原始参数数据
• 服务端返回的TraceId及完整请求日志

排查与解决步骤 #

1. 确认具体错误类型
   先打开浏览器控制台的网络面板，找到对应失败的POST请求，查看返回的HTTP状态码：

• 如果是4xx状态码：属于请求类错误，优先检查请求URL是否匹配后端路由、请求头Content-Type是否设置为application/json、传递的参数结构和字段是否和后端C#模型完全匹配，是否存在必填字段缺失、类型不匹配的问题。
• 如果是5xx状态码：属于服务端运行错误，根据TraceId去服务端日志中查询对应的异常栈，大概率是服务层的更新/插入逻辑运行时抛出了未捕获的异常，常见原因包括数据库约束冲突、空引用、事务执行失败等。

2. 修复模型绑定问题
   如果是400 Bad Request错误，绝大多数是模型绑定失败导致的：

• 确认后端接口的参数前是否添加了[FromBody]特性，否则无法正确解析POST请求体中的JSON数据
• 如果前端用驼峰命名字段、后端用帕斯卡命名，需要在服务端添加JSON序列化配置，开启大小写不敏感的绑定规则，避免字段名不匹配导致绑定失败。

3. 优化混合操作逻辑
   在同一个请求中同时执行更新和插入操作时，必须添加事务控制，保证两个操作的原子性：要么全部成功，要么全部回滚，避免出现部分执行成功导致的数据不一致问题。
4. 添加全局异常捕获
   建议在服务端添加全局异常中间件，捕获所有未处理的异常并返回结构化的错误信息，方便前端直接定位问题，避免只返回通用的Http failure响应。

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