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个最佳实践
- 按"使用频率"选择生命周期
- 全局共享→Singleton
- 请求内共享→Scoped
- 单次操作→Transient
- 优先用构造函数注入
避免[FromServices]属性注入,显式声明依赖更清晰。 - 用接口隔离服务
注册时用接口而非具体类,例如AddScoped<IDbContext, AppDbContext>(),方便后续替换实现。
总结:一句话记住
"单例全局用,作用域随请求,瞬态单次用"
你在项目中踩过依赖注入的坑吗?评论区分享你的经历,点赞最高送《.NET性能优化手册》!
参考资料:
- Microsoft Learn官方文档
- ASP.NET Core依赖注入最佳实践
相关推荐
- 如何为MySQL服务器和客户机启用SSL?
-
用户想要与MySQL服务器建立一条安全连接时,常常依赖VPN隧道或SSH隧道。不过,获得MySQL连接的另一个办法是,启用MySQL服务器上的SSL封装器(SSLwrapper)。这每一种方法各有其...
- 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的支付、退款等操作都会失败,将直接影响您的业务。请按照以下详细步骤进行操作:重要前提:分清...