Czar.Cms配置文件与AutoFac依赖注入实战：如何构建自动扫描整个程序集的DI容器

Czar.Cms配置文件与AutoFac依赖注入实战：如何构建自动扫描整个程序集的DI容器

【免费下载链接】Czar.Cms.NET Core实战项目之CMS系列教程的源码，精简而又功能丰富的权限设计，内容管理设计让你轻松搭建一个ASP.NET Core2.2的网站系统.此项目准备用EFCore进行重构，敬请期待项目地址: https://gitcode.com/gh_mirrors/cz/Czar.Cms

Czar.Cms 是一个精简而功能丰富的 .NET Core CMS 系统源码，内置权限管理、内容管理与定时任务。本文带你实战解析 Czar.Cms 的配置文件体系与 AutoFac 依赖注入玩法：从 appsettings.json 读取数据库配置，到用几行代码构建一个自动扫描整个程序集的 DI 容器，让 Repository 与 Service 层"零手动注册"。

🧭 项目一览：Czar.Cms 的分层结构

Czar.Cms 采用经典的分层架构，整个解决方案位于src/目录，各层职责清晰：

💡 正是靠下面要讲的配置文件 + AutoFac 容器，各层才能在Startup.cs启动时"即插即用"，最终渲染出这个后台登录页。

📄 配置文件实战：连接串到底放在哪

1. 核心配置都在 appsettings.json

Czar.Cms 的 Web 配置入口是 appsettings.json，数据库相关配置集中在DbOpion节中：

"DbOpion": { "ConnectionString": "Data Source=.;Initial Catalog=CzarCms;User ID=sa;Password=1;...", "DbType": "SqlServer" }

开发环境则通过 appsettings.Development.json 覆盖日志级别——ASP.NET Core 会按"环境合并"策略自动叠加两个文件，你只需要改对应环境的文件即可，互不干扰。

2. 配置绑定成强类型选项类

裸读字符串不如绑定成类。Czar.Cms 在 DbOption.cs 中定义了只有ConnectionString和DbType两个属性的选项类，然后在 Startup.cs 中一行完成绑定：

services.Configure<DbOption>("CzarCms", Configuration.GetSection("DbOpion"));

注意这里多了一个选项名"CzarCms"，配合IOptionsSnapshot<DbOption>的options.Get("CzarCms")使用，意味着同一应用可以绑定多份不同来源的配置，互不串扰。

3. 日志配置独立成 Nlog.config

日志由 NLog 负责，规则写在 Nlog.config 中：Czar.Cms.*命名空间下的日志写入数据库NLog表，而Microsoft.*的框架日志全部"扔进黑洞"。该文件通过 csproj 中的CopyToOutputDirectory配置保证发布时随站点一起输出。

🚀 AutoFac 构建 DI 容器：四步法自动扫描程序集

C# 依赖注入的精髓是"面向接口编程 + 运行时装配"。Czar.Cms 没有用框架默认的AddScoped逐个注册，而是引入 AutoFac，用类型命名约定一次性装配整个程序集。核心代码在 Startup.cs：

var builder = new ContainerBuilder(); builder.Populate(services); // 第1步：把 Microsoft DI 的服务"搬"进 AutoFac builder.RegisterAssemblyTypes(typeof(ManagerRoleRepository).Assembly) .Where(t => t.Name.EndsWith("Repository")) .AsImplementedInterfaces(); // 第2步：扫描仓储层程序集 builder.RegisterAssemblyTypes(typeof(ManagerRoleService).Assembly) .Where(t => t.Name.EndsWith("Service")) .AsImplementedInterfaces(); // 第3步：扫描业务层程序集 return new AutofacServiceProvider(builder.Build()); // 第4步：接管服务提供

四步法拆解如下：

🧩 约定大于配置：命名即注册

这套玩法的"钥匙"是命名约定——类名必须以 Repository 或 Service 结尾。例如 ManagerRoleRepository.cs 中：

public class ManagerRoleRepository : BaseRepository<ManagerRole, int>, IManagerRoleRepository { public ManagerRoleRepository(IOptionsSnapshot<DbOption> options) { _dbOption = options.Get("CzarCms"); _dbConnection = ConnectionFactory.CreateConnection(_dbOption.DbType, _dbOption.ConnectionString); } }

可以看到，仓储的构造函数通过IOptionsSnapshot<DbOption>注入配置，再由 ConnectionFactory.cs 按DbType创建 SqlServer / MySQL / PostgreSQL 三种连接——换数据库只改配置，不改代码。

后续新增业务模块时，你只需要：

1. 在Czar.Cms.IRepository里写接口IXxxRepository；
2. 在Czar.Cms.Repository.SqlServer里写XxxRepository实现；
3. 命名以Repository结尾——完成，无需回到 Startup.cs 改一行代码。

这就是"自动扫描整个程序集"的价值：注册逻辑从"每个类一行代码"变成"一个规则扫一遍"，漏注册的可能性基本归零。

⚠️ 实战要点与常见坑

• 🔍 节名必须一字不差：appsettings.json中的节名是DbOpion（作者的小拼写失误），代码里GetSection("DbOpion")必须与之完全一致，否则绑定出来是 null，运行时才炸。
• 🔒 单例要单独注册：如ScheduleCenter这类带状态的服务，用services.AddSingleton<ScheduleCenter>()显式注册（Startup.cs），不要交给约定扫描。
• 🧵 扫描范围要精准：RegisterAssemblyTypes是按"程序集"扫描的，仓储与业务分属两个程序集分别注册，避免把不该注册的类型扫进来。
• 📦 Populate 不能少：忘记builder.Populate(services)是最常见的坑，症状是"AutoFac 解析不到 IMvcBuilder 系的服务"，报错信息往往还很迷惑。

🔚 小结

配置决定"系统怎么连"，DI 容器决定"系统怎么活"。读懂了 Czar.Cms 的这套组合拳，你在自己的 ASP.NET Core 项目里也可以轻松搭出"命名即注册"的自动装配体系。

【免费下载链接】Czar.Cms.NET Core实战项目之CMS系列教程的源码，精简而又功能丰富的权限设计，内容管理设计让你轻松搭建一个ASP.NET Core2.2的网站系统.此项目准备用EFCore进行重构，敬请期待项目地址: https://gitcode.com/gh_mirrors/cz/Czar.Cms