0

0

ASP.NET Core中的中间件依赖注入是什么?如何实现?

月夜之吻

月夜之吻

发布时间:2025-09-11 08:42:01

|

528人浏览过

|

来源于php中文网

原创

ASP.NET Core中间件依赖注入通过构造函数注入服务,提升灵活性与可测试性,支持日志、配置、数据库等服务的注入。推荐使用构造函数注入,将服务声明在中间件构造函数中,由DI容器自动解析,如ILogger、IOptions等;避免手动通过context.RequestServices获取服务,以减少冗余代码并便于单元测试。可通过IOptions注入配置类实现外部配置,最佳实践包括保持中间件简洁、避免直接访问数据库、不使用静态变量,并优先使用构造函数注入而非ActivatorUtilities.CreateInstance或工厂模式,以确保代码清晰、可维护。

asp.net core中的中间件依赖注入是什么?如何实现?

ASP.NET Core中的中间件依赖注入,简单来说,就是让你的中间件也能像Controller那样,通过构造函数注入各种服务,从而获得更大的灵活性和可测试性。它允许你将配置、日志、数据库上下文等服务注入到你的中间件中,而不用手动去解析

HttpContext.RequestServices
,让代码更干净、更易于维护。

解决方案:

实现ASP.NET Core中间件的依赖注入,主要有以下几种方式:

  1. 构造函数注入 (Constructor Injection): 这是最常见也是推荐的方式。 你需要在中间件的构造函数中声明你需要的服务,ASP.NET Core的依赖注入容器会自动解析这些服务并传递给你的中间件。

    public class MyMiddleware
    {
        private readonly RequestDelegate _next;
        private readonly ILogger _logger;
    
        public MyMiddleware(RequestDelegate next, ILogger logger)
        {
            _next = next ?? throw new ArgumentNullException(nameof(next));
            _logger = logger ?? throw new ArgumentNullException(nameof(logger));
        }
    
        public async Task InvokeAsync(HttpContext context)
        {
            _logger.LogInformation("MyMiddleware executing...");
            await _next(context); // 调用管道中的下一个中间件
        }
    }
    
    public static class MyMiddlewareExtensions
    {
        public static IApplicationBuilder UseMyMiddleware(this IApplicationBuilder builder)
        {
            return builder.UseMiddleware();
        }
    }

    在这个例子中,

    ILogger
    就是通过构造函数注入的。 需要注意的是,
    RequestDelegate next
    必须作为构造函数的第一个参数,这是ASP.NET Core中间件的约定。

  2. 使用

    ActivatorUtilities.CreateInstance
    手动解析: 虽然不推荐,但在某些特殊情况下,你可能需要手动创建中间件实例。
    ActivatorUtilities.CreateInstance
    可以从DI容器中解析依赖并创建对象。

    app.Use(async (context, next) =>
    {
        var logger = context.RequestServices.GetService>(); // 不推荐,应该使用构造函数注入
        // ...
        await next();
    });

    这种方式的缺点是,你需要在每个中间件中使用

    context.RequestServices
    手动获取服务,代码比较冗余,而且测试起来也比较麻烦。

  3. 工厂模式 (Factory Pattern): 对于更复杂的场景,你可以使用工厂模式来创建中间件。 这允许你控制中间件的创建过程,并可以根据不同的条件创建不同的中间件实例。

    public interface IMyMiddlewareFactory
    {
        IMyMiddleware Create(HttpContext context);
    }
    
    public interface IMyMiddleware
    {
        Task InvokeAsync(HttpContext context);
    }
    
    public class MyMiddlewareFactory : IMyMiddlewareFactory
    {
        private readonly ILogger _logger;
    
        public MyMiddlewareFactory(ILogger logger)
        {
            _logger = logger;
        }
    
        public IMyMiddleware Create(HttpContext context)
        {
            return new MyMiddleware(context, _logger);
        }
    }
    
    public class MyMiddleware : IMyMiddleware
    {
        private readonly HttpContext _context;
        private readonly ILogger _logger;
    
        public MyMiddleware(HttpContext context, ILogger logger)
        {
            _context = context;
            _logger = logger;
        }
    
        public async Task InvokeAsync(HttpContext context)
        {
            _logger.LogInformation("MyMiddleware executing...");
            await context.Response.WriteAsync("Hello from MyMiddleware!");
        }
    }
    
    // 在 Startup.cs 中注册
    services.AddScoped();
    
    // 在管道中使用
    app.Use(async (context, next) =>
    {
        var factory = context.RequestServices.GetRequiredService();
        var middleware = factory.Create(context);
        await middleware.InvokeAsync(context);
        await next();
    });

    这种方式比较复杂,但提供了更大的灵活性。

    Tellers AI
    Tellers AI

    Tellers是一款自动视频编辑工具,可以将文本、文章或故事转换为视频。

    下载

为什么中间件需要依赖注入?它解决了什么问题?

依赖注入使得中间件的配置更加灵活,并简化了单元测试。想象一下,如果你的中间件需要访问数据库,但你没有使用依赖注入,你可能需要在中间件内部硬编码数据库连接字符串,这使得代码难以维护和测试。 使用依赖注入,你可以将数据库上下文注入到中间件中,并在单元测试中使用Mock对象来模拟数据库访问。

如何处理中间件中的配置信息?

通常,中间件的配置信息可以通过

IOptions
接口注入。首先,你需要创建一个配置类,然后将配置类注册到DI容器中,最后,在中间件的构造函数中注入
IOptions

// 配置类
public class MyMiddlewareOptions
{
    public string Message { get; set; } = "Hello from MyMiddleware!";
}

// 在 Startup.cs 中注册
services.Configure(Configuration.GetSection("MyMiddleware"));

// 在中间件中使用
public class MyMiddleware
{
    private readonly RequestDelegate _next;
    private readonly IOptions _options;

    public MyMiddleware(RequestDelegate next, IOptions options)
    {
        _next = next ?? throw new ArgumentNullException(nameof(next));
        _options = options ?? throw new ArgumentNullException(nameof(options));
    }

    public async Task InvokeAsync(HttpContext context)
    {
        await context.Response.WriteAsync(_options.Value.Message);
        await _next(context);
    }
}

这样,你就可以通过

appsettings.json
环境变量来配置中间件的行为,而无需修改中间件的代码。

中间件依赖注入的最佳实践是什么?

  • 使用构造函数注入: 这是最简单、最常用、也是最推荐的方式。
  • 避免在中间件中直接访问数据库: 尽量将数据库访问逻辑封装到单独的服务中,然后将服务注入到中间件中。
  • 使用
    IOptions
    来处理配置信息:
    这使得你的中间件可以灵活地配置,而无需修改代码。
  • 保持中间件的简洁: 中间件应该只关注于处理HTTP请求,尽量将复杂的逻辑放到单独的服务中。
  • 编写单元测试: 确保你的中间件能够正确地处理各种情况。
  • 避免在中间件中使用静态变量: 中间件是单例的,静态变量可能会导致线程安全问题。
  • 谨慎使用
    ActivatorUtilities.CreateInstance
    除非你真的需要手动创建中间件实例,否则应该尽量使用构造函数注入。

总之,ASP.NET Core中的中间件依赖注入是一个强大的特性,它可以让你编写更加灵活、可测试、易于维护的中间件。 掌握这些技巧,能让你在构建ASP.NET Core应用时更加得心应手。

相关专题

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

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

178

2024.05.11

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

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

213

2025.12.18

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

415

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

533

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

310

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

75

2025.09.10

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

258

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

209

2023.09.04

AO3中文版入口地址大全
AO3中文版入口地址大全

本专题整合了AO3中文版入口地址大全,阅读专题下面的的文章了解更多详细内容。

1

2026.01.21

热门下载

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

精品课程

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

共16课时 | 2万人学习

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

共1课时 | 0.3万人学习

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

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