当前位置：首页 > news >正文

ASP.NET Core Web API 中 HTTP状态码的分类及对应的返回方法

news 来源：原创 2025/9/6 0:34:20

文章目录

前言
一、HTTP状态码分类及常用方法
二、具体返回方法示例
1） 2xx 成功类
- 2）4xx 客户端错误
- 3）5xx 服务器错误
- 4）其他特殊状态码
三、高级返回方式
- 1）使用 IActionResult 与 ActionResult<T>
- 2）统一错误处理（Problem Details）
- 3）自定义状态码结果
四、最佳实践建议
- 优先使用内置方法
- POST创建资源时返回201
- 模型验证统一处理
- 异步方法一致处理
- 生产环境隐藏敏感错误
总结

前言

在ASP.NET Core Web API中，HTTP状态码用于表示请求的处理结果。

一、HTTP状态码分类及常用方法

类别	常见状态码	内置辅助方法	使用场景
信息响应	100	StatusCode(100)	协议切换请求
成功响应	200	Ok() / Ok(object)	标准GET请求成功
	201	CreatedAtAction() / CreatedAtRoute	资源创建成功（POST）
	202	Accepted()	请求已接受但未完成处理
	204	NoContent()	成功但无返回内容（DELETE常用）
重定向	301	RedirectPermanent()	永久重定向
	302	Redirect()	临时重定向
客户端错误	400	BadRequest()	请求参数无效
	401	Unauthorized()	未授权访问（未登录）
	403	Forbid()	已登录但权限不足
	404	NotFound()	资源不存在
	409	Conflict()	资源冲突（如重复创建）
	422	UnprocessableEntity()	请求语义正确但验证失败（常用于REST API）
服务器错误	500	StatusCode(500) / Problem()	未处理的服务器错误
	503	StatusCode(503)	服务不可用（维护或过载）

二、具体返回方法示例

1） 2xx 成功类

示例

// 200 OK（带数据）
[HttpGet("{id}")]
public ActionResult<Item> GetItem(int id)
{var item = _repository.GetItem(id);return Ok(item); // 自动序列化对象为JSON
}// 201 Created（创建资源）
[HttpPost]
public IActionResult CreateItem(Item item)
{_repository.Add(item);return CreatedAtAction(nameof(GetItem), new { id = item.Id }, item);
}// 204 No Content（删除成功）
[HttpDelete("{id}")]
public IActionResult DeleteItem(int id)
{_repository.Delete(id);return NoContent();
}

2）4xx 客户端错误

示例

// 400 Bad Request（手动验证）
[HttpPost]
public IActionResult PostItem(Item item)
{if (item.Price <= 0){return BadRequest("价格必须大于0");}return Ok();
}// 401 Unauthorized（未授权）
[HttpGet("secret")]
public IActionResult GetSecret()
{if (!User.Identity.IsAuthenticated){return Unauthorized();}return Ok("机密数据");
}// 422 Unprocessable Entity（验证失败）
[HttpPost("validate")]
public IActionResult ValidateItem(Item item)
{if (!ModelState.IsValid){return UnprocessableEntity(ModelState); // 返回详细错误}return Ok();
}

3）5xx 服务器错误

示例

// 500 Internal Server Error（自定义错误）
[HttpGet("error")]
public IActionResult ThrowError()
{try{throw new Exception("测试异常");}catch (Exception ex){return Problem(title: "服务器错误",detail: ex.Message,statusCode: 500);}
}// 503 Service Unavailable（服务不可用）
[HttpGet("maintenance")]
public IActionResult Maintenance()
{return StatusCode(503, new { Message = "系统维护中，请稍后重试" });
}

4）其他特殊状态码

示例

// 418 I'm a teapot（彩蛋状态码）
[HttpGet("teapot")]
public IActionResult Teapot() => StatusCode(418);// 429 Too Many Requests（限流）
[HttpGet("limited")]
public IActionResult LimitedRequest()
{Response.Headers.Add("Retry-After", "60"); // 添加响应头return StatusCode(429);
}

三、高级返回方式

1）使用 IActionResult 与 ActionResult

示例

// 动态返回类型
[HttpGet("dynamic/{id}")]
public ActionResult<Item> GetDynamic(int id)
{var item = _repository.GetItem(id);return item != null ? item : NotFound();
}

2）统一错误处理（Problem Details）

示例

// 返回RFC 7807标准错误格式
[HttpGet("problem")]
public IActionResult GetProblem()
{return Problem(detail: "余额不足",instance: HttpContext.Request.Path,statusCode: 400,title: "支付失败");
}

3）自定义状态码结果

示例

// 继承ActionResult自定义返回
public class CustomResult : ActionResult
{public override void ExecuteResult(ActionContext context){context.HttpContext.Response.StatusCode = 299;context.HttpContext.Response.WriteAsync("自定义状态码");}
}// 使用自定义结果
[HttpGet("custom")]
public IActionResult GetCustom() => new CustomResult();

四、最佳实践建议

优先使用内置方法

Ok()、NotFound() 等方法更易读且自动处理序列化。

POST创建资源时返回201

必须包含Location头指向新资源（通过CreatedAtAction或CreatedAtRoute）。

模型验证统一处理

使用 [ApiController] 特性时，无效模型自动返回400错误。

异步方法一致处理

异步方法返回Task<IActionResult>，用法与同步方法一致。

生产环境隐藏敏感错误

通过中间件（如UseExceptionHandler）统一处理500错误，避免泄露堆栈信息。

总结

通过适配的方法，可以清晰、规范地在ASP.NET Core Web API中返回各类HTTP状态码，满足RESTful API的设计要求

ASP.NET Core Web API 中 HTTP状态码的分类及对应的返回方法

文章目录前言一、HTTP状态码分类及常用方法二、具体返回方法示例1） 2xx 成功类2）4xx 客户端错误3）5xx 服务器错误4）其他特殊状态码三、高级返回方式1）使用 IActionResult 与 ActionResult<T>2）统一…...

编程日记 2025/9/6 0:34:20

函数和模式化——python

一、模块和包将一段代码保存为应该扩展名为.py 的文件，该文件就是模块。Python中的模块分为三种，分别为：内置模块、第三方模块和自定义模块。内置模块和第三方模块又称为库内置模块，有 python 解释器自带，不用单独安…...

编程日记 2025/9/5 2:01:26

LeetCode 1817 查找用户活跃分钟数

深入剖析 LeetCode 用户活跃分钟数统计问题一、题目详情给定用户在 LeetCode 的操作日志，日志以二维整数数组logs表示，其中每个logs[i][IDi, timei]，意味着 ID 为IDi的用户在timei分钟时执行了某个操作。多个用户能够同时执行操作&#x…...

编程日记 2025/9/4 14:29:49

matlab从pytorch中导入LeNet-5网络框架

文章目录一、Pytorch的LeNet-5网络准备二、保存用于导入matlab的model三、导入matlab四、用matlab训练这个导入的网络这里演示从pytorch的LeNet-5网络导入到matlab中进行训练用。一、Pytorch的LeNet-5网络准备根据LeNet-5的结构图，我们可以写如下结构 import…...

编程日记 2025/9/3 22:24:42

网络：华为HCIA学习笔记：ICMP协议

ICMP（Internet Control Message Protocol）Internet控制消息协议前言ICMPICMP重定向ICMP差错监测ICMP错误报告ICMP数据包格式ICMP消息类型和编码类型ICMP应用-PingICMP应用-Tracert 总结前言 Internet控制消息协议ICMP (Internet Control Message Prot…...

编程日记 2025/9/5 12:58:10

Visio | 将(.vsdx)导出为更清楚/高质量的图片(.png) | 在Word里面的visio图

此时大家在用Visio画完图直接复制到word里面后，如果后期需要重新保存高清图片，但是此时图片在word，是不是很多人会选择直接crtlA截图复制，这样出来的图又不清晰又小，完全不符合你导的审美，接下来跟着我&…...

编程日记 2025/9/6 0:33:06

算法设计学习8

实验目的及要求： 通过深入学习树（Tree）和二叉树（Binary Tree）这两种重要的数据结构，掌握它们的基本概念、性质和操作，提高对树形结构的理解和应用能力。通过本实验，学生将深化对树和…...

编程日记 2025/9/6 0:30:26

Dive into Deep Learning - 2.4. Calculus (微积分)

Dive into Deep Learning - 2.4. Calculus {微积分} 1. Derivatives and Differentiation (导数和微分)1.1. Visualization Utilities 2. Chain Rule (链式法则)3. DiscussionReferences 2.4. Calculus https://d2l.ai/chapter_preliminaries/calculus.html For a long time, …...

编程日记 2025/9/1 9:39:27

kotlin中const 和val的区别

在 Kotlin 中，const 和 val 都是用来声明常量的，但它们的使用场景和功能有所不同： 1. val: val 用于声明只读变量，也就是不可修改的变量（类似于 Java 中的 final 变量）。它可以是任何类型，包括…...

编程日记 2025/9/6 0:31:36

Webpack中loader的作用。

文章目录前言1. 处理样式文件2. 处理 JavaScript 文件3. 处理其他文件总结前言在 Webpack 中，Loader 是用于对模块的源代码进行转换的工具，它能够将不同类型的文件（如 CSS、图片、字体、TypeScript 等）转换为有效的 JavaScrip…...

编程日记 2025/9/6 0:30:26

C++ 极简常用内容

C 极简常用内容 1. 类与对象定义：封装数据（成员变量）和行为（成员函数）的自定义类型。 Demo： class Car { public:string brand;void drive() { cout << brand << " is moving." …...

编程日记 2025/9/2 14:50:40

如何在windows 环境、且没有显卡的情况下用python跑通从ModelScope下载的大模型的调用

文章目录背景介绍源代码：安装调试过程1.设置第三方镜像源2.预先安装：3.在python中创建代码：4.最终修改程序,将device_map从“cuda”改成“auto”，大模型调用1.5B（1___5B)的5.最终跑出结果解释：示例&#x…...

编程日记 2025/9/6 0:31:35

MINIQMT学习课程Day10

开始获取股票数据课程的学习： 获取qmt账号的持仓情况后，我们进入下一步，如何获得当前账号的委托状况还是之前的步骤，打开qmt，选择独立交易， 之后使用pycharm，编写py文件导入包&#xff1a…...

编程日记 2025/9/6 0:33:07

如何彻底关闭Windows 10中的Xbox游戏栏

一、打工人的困扰：不速之客“Game Bar” 在日常工作中，许多使用Windows 10的用户常常被一个不起眼却频频打扰的系统功能困扰，那就是“Xbox游戏栏”（Game Bar）。当你正在专注处理紧急的Excel表格或准备PPT汇报&#xf…...

编程日记 2025/9/6 0:30:24

26考研资料分享考研资料合集百度网盘（仅供参考学习）

考研资料分享考研资料合集百度网盘（仅供参考学习） 通过网盘分享的文件：2026考研英语数学政治最新等3个文件链接1: https://pan.baidu.com/s/1JXBI9ROng4KAWHoaUHpkug?pwdjydb 提取码: jydb 链接2:https://pan.baidu.com/s/1a…...

编程日记 2025/9/6 0:31:05

59.基于ssm和vue学生考试成绩管理系统

目录 1.系统的受众说明 2.系统关键技术 2.1 java技术 2.2 MYSQL数据库 2.3 B/S结构 3.系统分析 3.1 可行性分析 3.1.1 技术可行性 3.1.2经济可行性 3.2 系统性能分析 3.3 系统功能分析 3.5系统流程分析 3.5.1登录流程 3.5.2注册流程 3.5.3添加信息流程 3.5.4删…...

编程日记 2025/9/6 0:33:04

常见的ETL工具分类整理

一、开源ETL工具 ‌Kettle（Pentaho Data Integration）--Spoon‌ 设计及架构：面向数据仓库建模的传统ETL工具。使用方式：C/S客户端模式，开发和生产环境需要独立部署，任务编写、调试、修改都在本地。底层架构…...

编程日记 2025/9/6 0:30:23

【leetcode100】数组中的第K个最大元素

1、题目描述给定整数数组 nums 和整数 k，请返回数组中第 k 个最大的元素。请注意，你需要找的是数组排序后的第 k 个最大的元素，而不是第 k 个不同的元素。你必须设计并实现时间复杂度为 O(n) 的算法解决此问题。示例 1: 输入: [3,2,…...

编程日记 2025/9/6 0:31:37

markdown语法学习

三化markdown语法研究对象系统化全局化结构化markdown语法富文本字体样式*斜体*，主题样式#，表格样式||，代码块样式，待办样式- [ ]样式之间互相协作，互不冲突待办斜体加粗标题删除线 public class{ //代码块 …...

编程日记 2025/9/2 8:22:24

Linux_4

开始学习ssh工具在做开发的时候，肯定不止一台服务器，那么假设每台服务器都是Linux服务器，要在服务器上操作就需要登入终端，即Terminal。ssh的作用就是可以通过一个服务器登陆上其他的服务器。登陆到哪个服务器看到的就是哪个服务器的终端terminal。 ssh登陆 ssh user@…...

编程日记 2025/9/6 0:29:01

Netty——连接超时与断开重连

文章目录 1. 处理连接超时和断开重连的原因2. 处理连接超时和断开重连的方法2.1 处理连接超时2.1.1 步骤一：配置连接超时时间2.1.2 步骤二：监听连接结果 2.2 处理断开重连2.2.1 步骤一：监听连接断开事件2.2.2 步骤二：实现重连逻辑…...

编程日记 2025/9/6 0:31:36

linux 进程/线程设置核亲和性

1，线程绑定内核 #include <pthread.h> #include <stdio.h> #include <stdlib.h> // 定义一个函数，用于设置线程的CPU亲和性 void set_thread_affinity(pthread_t thread, int cpu_id) { cpu_set_t cpuset; int s; // 清空CPU集…...

编程日记 2025/9/6 0:31:34

前端页面鼠标移动监控（鼠标运动、鼠标监控）鼠标节流处理、throttle、限制触发频率（setTimeout、clearInterval）

文章目录使用lodashjs库手动实现节流（通过判断之前设定的定时器setTimeout是否存在） 使用lodashjs库 <!DOCTYPE html> <html lang"zh-CN"><head><meta charset"UTF-8"><meta http-equiv"X-UA-Com…...

编程日记 2025/9/5 1:33:13

【MySQL基础-21】MySQL事务机制详解：原理、实现与最佳实践

在现代数据库系统中，事务机制是确保数据一致性和完整性的核心技术。MySQL作为最流行的开源关系型数据库之一，其事务实现机制对于开发者而言至关重要。本文将深入探讨MySQL的事务机制，包括核心概念、实现原理、隔离级别以及实际应用中的最佳实…...

编程日记 2025/9/2 8:22:03

Transformer+BO-SVM时间序列预测（Matlab）

TransformerBO-SVM时间序列预测（Matlab） 目录 TransformerBO-SVM时间序列预测（Matlab）效果一览基本介绍程序设计参考资料效果一览基本介绍普通的单变量时序已经用腻了，审稿人也看烦了，本期推出一期高创…...

编程日记 2025/9/3 23:00:21

Python循环控制语句

1. 循环类型概述 Python提供两种主要的循环结构： while循环 - 在条件为真时重复执行for循环 - 遍历序列中的元素 2. while循环基本语法 while 条件表达式:循环体代码示例 count 0 while count < 5:print(f"这是第{count1}次循环")count 13. f…...

编程日记 2025/9/2 8:21:54

4.4日西南竞篮，欧篮联，NBA，全扫盘

欧篮联扫盘 301奥林匹亚 vs 阿尔巴 （11.5），总分167.5：阿尔巴有伤病，点差11.5大，可能是接近比赛，总分较低，预测阿尔巴赢盘，总分低于167.5。 302埃菲斯 vs 贝红星 (-1.5)&a…...

编程日记 2025/9/4 9:44:48

面试可能会遇到的问题回答（嵌入式软件开发部分）

写在前面： 博主也是刚入社会的小牛马，如果下面有写的不好或者写错的地方欢迎大家指出~ 一、四大件基础知识 1、计算机组成原理 （1）简单介绍一下中断是什么。 ①回答： ②难度系数：★★ ③难点分析&…...

编程日记 2025/9/4 7:11:27

AI平台初步规划实现和想法

要实现一个类似Coze的工作流搭建引擎，可以结合SmartEngine作为后端工作流引擎，ReactFlow作为前端流程图渲染工具，以及Ant Design作为UI组件库。以下是实现的步骤和关键点： ### 1. 后端工作流引擎（SmartEngine&#xf…...

编程日记 2025/9/3 19:09:09

软件工程面试题（二十七）

1、j a v a 对象初始化顺序 1.类的初始化（initialization class & interface） 2.对象的创建（creation of new class instances）顺序：应为类的加载肯定是第一步的，所以类的初始化在前。大体的初始化顺序是：类初始化 -> 子类构造函数 -> 父类构造函数 -&g…...

编程日记 2025/9/5 6:57:38

CCF GESP C++编程六级认证真题 2025年3月

C 六级 2025 年 03 月题号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 答案 D B A B B B B A A A A A B C A 一、单选题第 1 题在面向对象编程中，类是一种重要的概念。下面关于类的描述中，不正确的是（ ）。 A. 类是一个抽象的概念&a…...

编程日记 2025/9/2 8:21:35

Cortex-M 上编写汇编函数

在 ARM Cortex-M 系列单片机中使用汇编语言编写函数时，需要特别注意寄存器的使用、栈管理、调用约定以及与 C 语言的兼容性。以下是关键注意事项和示例说明： 1. 遵循 AAPCS 调用约定 ARM 定义了 AAPCS（ARM Architecture Procedure Call Standard），规定了函数调用时寄存器…...

编程日记 2025/9/3 13:00:59

Spring 核心技术解析【纯干货版】- XXII：Spring 扫描效率提升模块 Spring-Context-Indexer 模块精讲

在 Spring 应用中，组件扫描（Component Scan） 是 Spring 容器启动时的关键任务之一。默认情况下，Spring 通过反射扫描整个类路径来找到所有 Component、Service、Repository 等注解的类，并将其注册为 Spring Bean。但…...

编程日记 2025/9/4 22:44:41

jetson AGX orin--ARM64 换源报错Packages 404 Not Found [IP: 2402:f000:1:400::2 443]

问题原因： ARM64结构不能使用X86结构的源，清华源不完全支持ARM64。使用下面这个源 sudo vim /etc/apt/sources.list 删掉原来的，改成这个 # ARM64 架构专用源 deb [archarm64] http://ports.ubuntu.com/ubuntu-ports focal main restrict…...

编程日记 2025/9/2 8:21:21

对备忘录模式的理解

对备忘录模式的理解一、场景1、题目【[来源](https://kamacoder.com/problempage.php?pid1095)】1.1 题目描述1.2 输入描述1.3 输出描述1.4 输入示例1.5 输出示例 2、理解需求二、不采用备忘录设计模式1、代码2、问题3、错误的备忘录模式三、采用备忘录设计模式1、代码1.1 …...

编程日记 2025/9/4 9:19:36

ngx_ssl_init

定义在 src\event\ngx_event_openssl.c ngx_int_t ngx_ssl_init(ngx_log_t *log) { #if OPENSSL_VERSION_NUMBER > 0x10100003Lif (OPENSSL_init_ssl(OPENSSL_INIT_LOAD_CONFIG, NULL) 0) {ngx_ssl_error(NGX_LOG_ALERT, log, 0, "OPENSSL_init_ssl() failed")…...

编程日记 2025/9/4 9:35:58

Roo Code（前身为 Roo Cline）一个 AI 驱动的自主编码代理

Roo Code（前身为 Roo Cline） Roo Code 是一个 AI 驱动的自主编码代理，它存在于您的编辑器中。它可以： 用自然语言沟通直接在您的工作区读写文件运行终端命令自动化浏览器操作与任何 OpenAI 兼容或自定义的 API/模型集成通过自定…...

编程日记 2025/9/5 13:23:29

每日一题洛谷P8649 [蓝桥杯 2017 省 B] k 倍区间c++

P8649 [蓝桥杯 2017 省 B] k 倍区间 - 洛谷 (luogu.com.cn) #include <iostream> #include <vector> using namespace std; #define int long long signed main() {int n, k;cin >> n >> k;vector<int> a(n 1);vector<int> sum(n 1);vec…...

编程日记 2025/9/2 8:21:04

CLion安装、配置及使用

目录 1 CLion是什么 2 CLion安装 3 系统环境变量配置 4 CLion配置 4.1 编辑器选择 4.2 编辑器配置 4.3 新建项目 5 总结 1 CLion是什么 CLion 是 JetBrains 推出的一款跨平台集成开发环境（IDE），专为 C 和 C 开发设计，支…...

编程日记 2025/9/4 20:24:42

UE5把动画导出为视频格式

UE5把动画导出为视频格式步骤一点击渲染视频或图片按钮旁边的三个圆点按钮步骤二点击渲染视频或图片按钮步骤三 1是修改输出视频的帧率格式 2输出视频的路径 3点击等待视频渲染完成以上是基本方法最新的输出视频方法请看这位大佬的视频...

编程日记 2025/9/2 8:20:55

SQL语句（三）—— DQL

目录基本语法一、基础查询 1、查询多个字段 2、字段设置别名 3、去除重复记录 4、示例代码二、条件查询 1、语法 2、条件列表常用的运算符 3、示例代码三、分组查询 （一）聚合函数 1、介绍 2、常见的聚合函数 3、语法 4、示例代码 &…...

编程日记 2025/9/3 19:59:28

[2017][note]基于空间交叉相位调制的两个连续波在few layer铋Bi中的全光switch——

前言类型太赫兹 + 全光开关太赫兹 + 全光开关太赫兹+全光开关期刊 A C S P H O T O N...

编程日记 2025/9/2 8:20:46

第十九节课： python第四周课程：程序分支结构详解

程序分支结构 1. 单分支结构语法结构： if <条件>:<代码块>执行逻辑： 条件为真时执行代码块类似自然语言中的"如果…则…" 应用案例： # 猜数字示例 guess eval(input("请输入数字：")) if …...

编程日记 2025/9/2 8:20:41

NSSCTF [HGAME 2023 week1]simple_shellcode

3488.[HGAME 2023 week1]simple_shellcode 手写read函数shellcode和orw [HGAME 2023 week1]simple_shellcode (1) motalymotaly-VMware-Virtual-Platform:~/桌面$ file vuln vuln: ELF 64-bit LSB pie executable, x86-64, version 1 (SYSV), dynamically linked, interpret…...

编程日记 2025/9/2 8:20:36

图形渲染中的定点数和浮点数

三种API的NDC区别 NDC全称，Normalized Device Coordinates Metal、Vulkan、OpenGL的区别如下： featureOpenGL NDCMetal NDCVulkan NDC坐标系右手左手右手z值范围[-1,1][0,1][0,1]xy视口范围[-1,1][-1,1][-1,1] GPU渲染的定点数和浮点数定点数类型&a…...

编程日记 2025/9/2 8:20:33