0

0

ASP.NET Core 中的自定义中间件如何编写?

煙雲

煙雲

发布时间:2025-10-28 22:33:02

|

506人浏览过

|

来源于php中文网

原创

自定义中间件用于处理HTTP请求响应逻辑,需包含RequestDelegate构造函数及InvokeAsync方法,通过UseMiddleware注册,可结合DI传递参数或实现IMiddleware接口以支持依赖作用域服务。

asp.net core 中的自定义中间件如何编写?

在 ASP.NET Core 中,自定义中间件用于处理 HTTP 请求和响应管道中的逻辑,比如日志记录、身份验证、异常处理等。编写自定义中间件非常灵活,可以通过类或内联方法实现,推荐使用类的方式以提高可维护性。

自定义中间件的基本结构

一个典型的中间件类包含以下要素:

  • 构造函数接收下一个中间件委托 RequestDelegate
  • 必须有一个名为 InvokeInvokeAsync 的公共方法,返回 Task
  • Invoke 方法中编写业务逻辑,并调用 _next(context) 继续执行管道

示例:记录请求耗时的中间件

public class RequestTimeMiddleware
{
    private readonly RequestDelegate _next;
public RequestTimeMiddleware(RequestDelegate next)
{
    _next = next;
}

public async Task InvokeAsync(HttpContext context)
{
    var startTime = DateTime.Now;

    await _next(context); // 继续执行后续中间件

    var endTime = DateTime.Now;
    var duration = endTime - startTime;

    Console.WriteLine($"请求 {context.Request.Path} 耗时: {duration.TotalMilliseconds}ms");
}

}

在程序中注册中间件

要使用自定义中间件,需在 Program.csUseMiddleware() 方法中注册。

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.UseMiddleware();

app.MapGet("/", () => "Hello World!"); app.Run();

传递参数给中间件

如果需要配置选项,可以结合依赖注入传入服务或配置对象。

C#开的网站购物交易系统
C#开的网站购物交易系统

一个用C#开的网站购物交易系统,带源码仅供学习参考,应用了WebCalendar控件。后台登陆帐号和密码分别为:admin admin WebCalendar控件是一个ASP.Net Web应用程序的日期控件,您可以通过设置控制控件中不同部分的样式的属性,来自定义 WebCalendar 控件的外观和图片;支持手动输入日期,支持输入时间,不会被TextBox,DropDownList遮挡。并且她是

下载
public class CustomHeaderMiddleware
{
    private readonly RequestDelegate _next;
    private readonly string _headerValue;
public CustomHeaderMiddleware(RequestDelegate next, string headerValue)
{
    _next = next;
    _headerValue = headerValue;
}

public async Task InvokeAsync(HttpContext context)
{
    context.Response.Headers["X-Custom-Header"] = _headerValue;
    await _next(context);
}

}

由于中间件构造函数不能直接接收非服务参数,可通过扩展方法封装:

public static class CustomHeaderExtensions
{
    public static IApplicationBuilder UseCustomHeader(
        this IApplicationBuilder builder, string value)
    {
        return builder.UseMiddleware(value);
    }
}

然后在 Program.cs 中使用:

app.UseCustomHeader("MyValue");

使用工厂模式创建中间件(高级)

若中间件需要依赖作用域服务,可使用 IMiddleware 接口,由容器管理生命周期。

public class ScopedLoggingMiddleware : IMiddleware
{
    private readonly ILogger _logger;
public ScopedLoggingMiddleware(ILogger logger)
{
    _logger = logger;
}

public async Task InvokeAsync(HttpContext context, RequestDelegate next)
{
    _logger.LogInformation("请求开始: {Path}", context.Request.Path);
    await next(context);
    _logger.LogInformation("请求结束: {Path}", context.Request.Path);
}

}

注册时需将中间件类型添加到服务容器:

builder.Services.AddTransient();
// ...
app.UseMiddleware();

基本上就这些。自定义中间件是构建可复用请求处理逻辑的核心方式,理解其执行顺序和生命周期有助于写出高效、清晰的管道逻辑。不复杂但容易忽略的是构造函数参数限制和作用域服务的正确使用。

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

176

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

212

2025.12.18

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1011

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

60

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

368

2025.12.29

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

324

2023.11.09

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

401

2023.11.14

HTTP 503错误解决方法
HTTP 503错误解决方法

HTTP 503错误表示服务器暂时无法处理请求。想了解更多http错误代码的相关内容,可以阅读本专题下面的文章。

1569

2024.03.12

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

97

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
【web前端】Node.js快速入门
【web前端】Node.js快速入门

共16课时 | 2万人学习

550W粉丝大佬手把手从零学JavaScript
550W粉丝大佬手把手从零学JavaScript

共1课时 | 0.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号