如何在类库契约中正确引用ASP.NET Core的IHeaderDictionary？

核心结论 #

在.NET 6+的契约类库项目中，应引用**Microsoft.AspNetCore.Http NuGet包**来获取IHeaderDictionary接口的定义，这是微软官方推荐的轻量契约依赖包。

具体说明 #

• Microsoft.AspNetCore.App.Ref是SDK内部使用的平台引用包，不支持在常规类库中直接引用；Microsoft.AspNetCore.App是框架元包，仅适用于ASP.NET Core应用项目，类库无法直接引用，这就是你之前遇到的引用失败原因。
• 旧的Microsoft.AspNetCore.Http.Features包已被废弃，微软已将IHeaderDictionary等核心HTTP契约迁移到Microsoft.AspNetCore.Http包中，这个包专门为类库设计，仅包含必要的抽象接口，完全适配跨仓库契约定义的场景。

操作步骤 #

1. 在契约类库项目中，通过NuGet包管理器安装Microsoft.AspNetCore.Http包，选择与目标.NET版本匹配的稳定版（比如.NET 6选6.x稳定版、.NET 7选7.x稳定版等）。
2. 安装完成后，在代码中添加using Microsoft.AspNetCore.Http;即可直接使用IHeaderDictionary接口。

方案合理性说明 #

ASP.NET Core在.NET 6及后续版本中优化了NuGet包结构：将核心抽象、契约拆分到独立的轻量包中，让类库可以只引入必要依赖，无需加载整个ASP.NET Core框架。Microsoft.AspNetCore.Http就是承担HTTP契约角色的包，包含所有请求/响应相关的抽象接口，完美契合你跨仓库定义契约的需求。

内容的提问来源于stack exchange，提问作者Al Kepp