0

0

C# 清洁架构实现方法 C#如何搭建一个Clean Architecture项目

煙雲

煙雲

发布时间:2026-03-10 09:45:12

|

994人浏览过

|

来源于php中文网

原创

clean architecture 翻车主因是误将其当作目录模板而非依赖约束;domain 必须纯 .net 类库、零 nuget 依赖,仅含实体、值对象、领域异常、仓储/领域服务接口,且接口定义在 domain、实现置于 infrastructure。

c# 清洁架构实现方法 c#如何搭建一个clean architecture项目

为什么直接套用 Clean Architecture 模板容易翻车

因为 Clean Architecture 不是目录结构模板,而是依赖方向约束。很多人照着 GitHub 上的示例建了 DomainApplicationInfrastructureWeb 四层,结果 Domain 里悄悄引用了 Microsoft.EntityFrameworkCore,或者 Application 直接 new 了一个 HttpClient —— 这已经违反了“内层不依赖外层”的核心规则。

关键判断点就一个:Domain 项目必须是纯 .NET Standard / .NET 6+ 类库,且 不能有任何 NuGet 包依赖(连 System.Text.Json 都不该有,除非目标框架不自带)。

Domain 层怎么写才真正“干净”

它只该包含:实体(Entity)、值对象(ValueObject)、领域异常(DomainException)、仓储接口(IRepository<t></t>)、领域服务接口(IDomainService)。所有类型都该是 public,但不暴露实现细节

Monica Search
Monica Search

Monica推出的AI搜索引擎

下载
  • Product 实体里不要写 EF Core 的 [Key][Column] 特性
  • 仓储接口方法名用领域语言,比如 FindActiveBySku(string sku),而不是 GetById(int id)
  • 别在 Domain 里定义 DTO 或 ViewModel —— 它们属于表现层契约,不是领域概念
  • 如果要用泛型仓储,接口定义在 Domain,实现放在 InfrastructureDomain 里只保留 IRepository<product></product> 这种具体契约

Application 层如何避免变成“胶水层”

它负责编排领域逻辑,但不处理数据访问、序列化、HTTP 协议细节。常见错误是把 Mapper.Map()JsonSerializer.Serialize() 塞进 CommandHandler

  • 所有输入输出都用 Request/Response 类(如 CreateProductCommand),它们是 Application 自己的 DTO,和 Domain 无关
  • 领域服务通过构造函数注入,类型必须是 Domain 中定义的接口,比如 IProductDomainService
  • 事务控制放在 Application 层(用 IUnitOfWork 接口),但实现(如 EF Core 的 SaveChangesAsync)在 Infrastructure
  • 不要在 Application 里写 try/catch (SqlException) —— 数据库异常应在 Infrastructure 转成领域异常再往上抛

Startup 和 DI 注入最容易漏掉的三件事

ASP.NET Core 6+ 项目中,Program.cs 是外层入口,它负责把 InfrastructurePresentation 的实现绑定到 DomainApplication 定义的接口上。这里错一点,整个架构就“漏气”。

  • 必须用 services.AddDbContext<appdbcontext>()</appdbcontext>,但 AppDbContext 类型只能出现在 Infrastructure 层,Program.cs 里不能出现它的命名空间引用
  • 仓储实现注册要匹配接口粒度:比如 services.AddScoped<iproductrepository productrepository>()</iproductrepository>,而不是一股脑扫 typeof(IRepository)
  • Application 层的 MediatR 手动注册(AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(CreateProductCommand).Assembly)))必须指向 Application 程序集,不能指向 WebInfrastructure

最常被忽略的是:所有跨层调用必须走接口,哪怕只有一个实现。没有接口的依赖(比如直接 new 一个 LoggerFactory)会立刻让 DomainApplication 对具体技术栈产生隐式耦合。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

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

454

2023.08.07

json是什么
json是什么

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

546

2023.08.23

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

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

334

2023.10.13

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

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

82

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

990

2023.08.02

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

990

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

607

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

314

2025.08.29

Kotlin Android模块化架构与组件化开发实践
Kotlin Android模块化架构与组件化开发实践

本专题围绕 Kotlin 在 Android 应用开发中的架构实践展开,重点讲解模块化设计与组件化开发的实现思路。内容包括项目模块拆分策略、公共组件封装、依赖管理优化、路由通信机制以及大型项目的工程化管理方法。通过真实项目案例分析,帮助开发者构建结构清晰、易扩展且维护成本低的 Android 应用架构体系,提升团队协作效率与项目迭代速度。

24

2026.03.09

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 11万人学习

C 教程
C 教程

共75课时 | 5.3万人学习

C++教程
C++教程

共115课时 | 21.2万人学习

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

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