dotnet-api

dotnet-api

概述

ASP.NET Core API、数据访问、后端服务、安全性和云原生模式。此整合技能涵盖 32 个主题领域。请根据下方路由表，从 references/ 加载相应的配套文件。

基础依赖项：references/minimal-apis.md 定义了 ASP.NET Core Minimal API 的核心模式（路由组、端点筛选器、TypedResults、参数绑定），适用于大多数 API 开发任务。构建 HTTP 端点时，默认加载该文件。

最常用的配套文件：references/architecture-patterns.md 涵盖纵向切片、请求管道、错误处理、缓存和幂等性模式，这些模式几乎适用于所有 ASP.NET Core 项目。

路由表

主题	关键词	描述	配套文件
Minimal API	endpoint、route group、filter、TypedResults	Minimal API 路由组、过滤器、TypedResults、OpenAPI	references/minimal-apis.md
中间件	管道顺序、短路、异常	管道顺序、短路、异常处理	references/middleware-patterns.md
EF Core 模式	DbContext、migrations、AsNoTracking	DbContext、AsNoTracking、查询拆分、migrations	references/efcore-patterns.md
EF Core 架构	读写分离、聚合边界、N+1	读写分离、聚合边界、N+1	references/efcore-architecture.md
数据访问策略	EF Core 与 Dapper、ADO.NET 的选择	EF Core 与 Dapper、ADO.NET 的决策矩阵	references/data-access-strategy.md
gRPC	proto、代码生成、流式传输、身份验证	Proto 定义、代码生成、ASP.NET Core 主机、流式传输	references/grpc.md
实时通信	SignalR、SSE、JSON-RPC、gRPC 流式传输	SignalR hub、SSE、JSON-RPC 2.0、扩展	references/realtime-communication.md
弹性	Polly v8、重试、断路器、超时	Polly v8 重试、断路器、超时、速率限制器	references/resilience.md
HTTP 客户端	IHttpClientFactory、类型化/命名、DelegatingHandler	IHttpClientFactory、类型化/命名客户端、DelegatingHandler	references/http-client.md
API 版本控制	Asp.Versioning、URL/标头/查询、弃用	Asp.Versioning.Http/Mvc、URL/标头/查询、弃用	references/api-versioning.md
OpenAPI	MS.AspNetCore.OpenApi、Swashbuckle、NSwag	MS.AspNetCore.OpenApi、Swashbuckle 迁移、NSwag	references/openapi.md
API 安全	Identity、OAuth/OIDC、JWT、CORS、速率限制	Identity、OAuth/OIDC、JWT bearer、CORS、速率限制	references/api-security.md
OWASP	注入、身份验证、XSS、已弃用的 API	面向 .NET 的 OWASP Top 10 加固	references/security-owasp.md
密钥	用户机密、环境变量、轮换	用户机密、环境变量、轮换	references/secrets-management.md
密码学	AES-GCM、RSA、ECDSA、哈希、密钥派生	AES-GCM、RSA、ECDSA、哈希、PQC 密钥派生	references/cryptography.md
后台服务	BackgroundService、IHostedService、生命周期	BackgroundService、IHostedService、生命周期	references/background-services.md
Aspire	AppHost、服务发现、仪表板	AppHost、服务发现、组件、仪表板	references/aspire-patterns.md
Semantic Kernel	AI/LLM 插件、提示词、记忆、Agent	AI/LLM 插件、提示词模板、记忆、Agent	references/semantic-kernel.md
架构	垂直切片、分层、管道、缓存	垂直切片、分层、管道、缓存	references/architecture-patterns.md
消息传递	Wolverine、Azure Service Bus、RabbitMQ、发布/订阅、saga	Wolverine、Azure Service Bus、RabbitMQ、发布/订阅、saga	references/messaging-patterns.md
服务通信	REST、gRPC、SignalR 的决策矩阵	REST、gRPC、SignalR 的决策矩阵	references/service-communication.md
API 表面验证	PublicApiAnalyzers、Verify、ApiCompat	PublicApiAnalyzers、Verify 快照、ApiCompat	references/api-surface-validation.md
库 API 兼容性	二进制/源代码兼容性、类型转发器	二进制/源代码兼容性、类型转发器、SemVer	references/library-api-compat.md
I/O 管道	PipeReader/PipeWriter、背压、Kestrel	PipeReader/PipeWriter、背压、Kestrel	references/io-pipelines.md
Agent 常见问题	async 误用、NuGet 错误、DI 错误	.NET 代码中 Agent 的常见错误	references/agent-gotchas.md
基于文件的应用	.NET 10、指令、csproj 迁移	.NET 10 基于文件的 C# 应用	references/file-based-apps.md
API 文档	DocFX、以 OpenAPI 作为文档、版本化文档	DocFX、以 OpenAPI 作为文档、版本化文档	references/api-docs.md
HybridCache	HybridCache、L1/L2、缓存击穿、按标签驱逐	HybridCache（.NET 9+）、缓存击穿保护、按标签驱逐	references/hybrid-cache.md
YARP	反向代理、负载均衡、API 网关、BFF	YARP 反向代理、负载均衡、运行状况检查、转换	references/yarp.md
输出缓存	OutputCache、响应缓存、压缩	输出/响应缓存、压缩、CDN、按标签失效	references/output-caching.md
Identity	ASP.NET Core Identity、登录、MFA、脚手架	Identity 设置、脚手架、外部提供程序、MapIdentityApi	references/identity-setup.md
Office 文档和 PDF	Excel、Word、PowerPoint、PDF、Open XML SDK、电子表格、docx、xlsx、PDFsharp、MigraDoc、合并 PDF、拆分 PDF、添加水印	使用 Open XML SDK、ClosedXML、PDFsharp/MigraDoc 创建、读取、合并、拆分 PDF 及添加水印	references/office-documents.md

范围

• ASP.NET Core Web API（最小 API 和基于控制器的 API）
• 数据访问（EF Core、Dapper、ADO.NET）
• 服务通信（gRPC、SignalR、SSE、消息传递）
• 安全性（身份验证、OWASP、机密信息、加密）
• 云原生（Aspire、弹性、后台服务）
• AI 集成（Semantic Kernel）
• 架构模式和 API 表面验证

不在范围内

• C# 语言功能 -> dotnet-csharp
• UI 渲染 -> dotnet-ui
• 测试编写 -> dotnet-testing
• CI/CD 流水线 -> dotnet-devops
• 构建工具 -> dotnet-tooling