百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

3分钟搞懂ASP.NET Core依赖注入:Singleton/Scoped/Transient实战

haoteby 2025-10-08 17:07 6 浏览

引言:为什么你的代码越改越乱?

最近接手一个老项目,发现Controller里堆满了new DatabaseContext()new RedisClient(),改一个功能要动五六个地方,Bug比头发还多!后来才发现,没用好依赖注入(DI) 是原罪。

今天用大白话+代码实例,带你彻底搞懂ASP.NET Core的三种服务生命周期,从此写出清爽可维护的代码!

一、什么是依赖注入?用人话解释

依赖注入 = "外卖模式"

  • 你(类)需要吃饭(服务),不用自己买菜做饭(new对象),直接点外卖(DI容器),小哥(框架)会把热乎的饭菜(实例)送到你手上。

核心好处

  • 解耦代码:改服务实现不用动调用方
  • 自动管理:用完自动回收,不担心内存泄漏
  • 方便测试:轻松替换成模拟服务

二、三分钟分清三种生命周期(重点)

生命周期

通俗理解

举个栗子

适合场景

Singleton

全局唯一"单例"

公司前台(所有人共用一个)

配置、缓存、日志服务

Scoped

一次请求"专属"

餐厅服务员(一桌一个)

数据库上下文(DbContext)、用户会话

Transient

用完就扔"临时工"

一次性筷子(用一次换一个)

工具类(加密、邮件发送)

形象对比


Singleton像公司饮水机,Scoped像你工位的杯子,Transient像一次性纸杯

三、代码实战:注册与使用

1. 注册服务(Program.cs中)

var builder = WebApplication.CreateBuilder(args);

// 单例:全局缓存(整个应用共用一个)
builder.Services.AddSingleton<ICacheService, MemoryCacheService>();

// 作用域:数据库上下文(每个请求一个新实例)
builder.Services.AddScoped<AppDbContext>();

// 瞬态:邮件服务(每次调用新建实例)
builder.Services.AddTransient<IEmailSender, SmtpEmailSender>();

2. 使用服务(控制器中)

public class OrderController : Controller
{
    private readonly ICacheService _cache;
    private readonly AppDbContext _dbContext;

    // 构造函数注入(推荐)
    public OrderController(ICacheService cache, AppDbContext dbContext)
    {
        _cache = cache;       // 单例服务
        _dbContext = dbContext; // 作用域服务
    }

    public IActionResult GetOrder(int id)
    {
        // 瞬态服务:需要时通过方法注入
        var emailSender = HttpContext.RequestServices.GetService<IEmailSender>();
        emailSender.Send("订单查询通知", #34;用户查询了订单{id}");

        return Ok(_dbContext.Orders.Find(id));
    }
}

四、避坑指南:90%的人会犯的3个错误

1. 生命周期不匹配(最致命)


错误代码:在单例服务中注入作用域服务

//  错误示范
services.AddSingleton<OrderService>();
services.AddScoped<AppDbContext>();

public class OrderService 
{
    // 单例依赖作用域服务,会导致上下文被释放后使用
    public OrderService(AppDbContext dbContext) { ... }
}

解决:改用IServiceScopeFactory手动创建作用域

2. 循环依赖
服务A依赖B,B又依赖A,导致DI容器无法解析。
解决

  • 拆分成更小的服务
  • Lazy<T>延迟加载依赖

3. 过度使用Transient
频繁创建实例会增加性能开销,
无状态且轻量的服务才用Transient

五、老司机的3个最佳实践

  1. 按"使用频率"选择生命周期
  2. 全局共享→Singleton
  3. 请求内共享→Scoped
  4. 单次操作→Transient
  5. 优先用构造函数注入
    避免
    [FromServices]属性注入,显式声明依赖更清晰。
  6. 用接口隔离服务
    注册时用接口而非具体类,例如
    AddScoped<IDbContext, AppDbContext>(),方便后续替换实现。

总结:一句话记住

"单例全局用,作用域随请求,瞬态单次用"

你在项目中踩过依赖注入的坑吗?评论区分享你的经历,点赞最高送《.NET性能优化手册》!


参考资料

  • Microsoft Learn官方文档
  • ASP.NET Core依赖注入最佳实践

相关推荐

如何为MySQL服务器和客户机启用SSL?

用户想要与MySQL服务器建立一条安全连接时,常常依赖VPN隧道或SSH隧道。不过,获得MySQL连接的另一个办法是,启用MySQL服务器上的SSL封装器(SSLwrapper)。这每一种方法各有其...

OpenVPN客户端配置_openvpn客户端配置文件解析

...

k8s 证书问题排查_k8s dashboard 证书

从去年开始一些老项目上陆陆续续出现一些列的证书问题,(证书原理这里就不说了,官方文档一堆)多数刚开始的表现就是节点的kubelet服务起不来,节点状态NotReady表现日志如下failed...

企业级网络互通方案:云端OpenVPN+爱快路由器+Win11互联实战

企业级网络互通方案:OpenVPN搭建公有云+爱快路由器+Win11三地互联实战指南「安全高效」三地局域网秒变局域网实施环境说明...

OpenV** Server/Client配置文件详解

Server配置详解...

接口基础认知:关键信息与合规前提

1.核心技术参数(必记)...

S交换机通过SSH登录设备配置示例(RADIUS认证+本地认证独立)

说明:●本示例只介绍设备的认证相关配置,请同时确保已在RADIUS服务器上做了相关配置,如设备地址、共享密钥、创建用户等配置。●通过不同的管理域来实现RADIUS认证与本地认证两种方式同时使用,两...

SSL证书如何去除私钥密码保护_ssl证书怎么取消

有时候我们在生成证书的时候可以加入了密码保护。然后申请到证书安装到了web服务器。但是这样可能会带来麻烦。每次重启apache或者nginx的时候,都需要输入密码。那么SSL证书如何去除私钥密码保护。...

SSL证书基础知识与自签名证书生成指南

一、证书文件类型解析...

S交换机通过SSH登录设备配置示例(RADIUS认证)

说明:本示例只介绍设备的认证相关配置,请同时确保已在RADIUS服务器上做了相关配置,如设备地址、共享密钥、创建用户等配置。假设已在RADIUS服务器上创建了用户名yc123,密码test#123。对...

HTTPS是什么?加密原理和证书。SSL/TLS握手过程

秘钥的产生过程非对称加密...

HTTPS TLS握手流程_进行tls握手

1.客户端向服务器发送`ClientHello`消息,包括支持的TLS版本、加密套件、随机数等信息。2.服务器收到`ClientHello`消息后,解析其中的信息,并根据配置选择一个加密套件。3....

Spring Boot 单点登录(SSO)实现_spring boot 单点登录jwt

SpringBoot单点登录(SSO)实现全指南单点登录(SingleSign-On,SSO)是一种身份验证机制,允许用户使用一组凭证登录多个相关但独立的系统。在微服务架构和企业级系统中,SS...

源码分享:在pdf上加盖电子签章_pdf如何加盖电子公章

在pdf上加盖电子签章,并不是只是加个印章图片,。而是要使用一对密钥中的私钥对文件进行签字。为啥要用私钥呢?很简单,因为公钥是公开的,其他人才可以用公钥为你证明,这个文件是你签的。这就是我们常说的:私...

微信支付商户API证书到期 怎么更换

微信支付商户API证书到期更换是一个非常重要的操作,需要仔细按照流程进行。如果证书过期,所有通过API的支付、退款等操作都会失败,将直接影响您的业务。请按照以下详细步骤进行操作:重要前提:分清...