<p>C# Web API 中 Accept 头未生效的根本原因是未启用内容协商或格式器配置不当；需继承 ControllerBase、注册 JSON/XML 格式器、精确匹配 MIME 类型，避免 FileResult 和手动序列化绕过协商流程。</p>
Accept 头没被 C# Web API 正确读取
常见现象是客户端发 Accept: application/json，但接口始终返回 XML 或固定格式。根本原因不是头没传过来，而是 ASP.NET Core 默认不启用基于 Accept 的内容协商（Content Negotiation），或者控制器没配置响应格式支持。
实操建议：
- 确保控制器继承
ControllerBase（不是Controller），并启用AddControllersAsServices()（.NET 5+ 可省略） - 在
Startup.ConfigureServices或Program.cs中显式注册格式器：services.AddControllers(options =><br> options.ReturnHttpNotAcceptable = true)<br>.AddXmlSerializerFormatters()<br>.AddJsonOptions();
-
Accept头值必须精确匹配格式器注册的 MIME 类型，比如application/xml才触发 XML 序列化，text/xml不会生效
FileResult 返回文件时 Accept 头失效
用 FileStreamResult、PhysicalFileResult 等直接返回二进制流时，内容协商机制完全绕过——框架不会检查 Accept，也不会重写 Content-Type。这是设计使然，不是 bug。
实操建议：
- 如果目标是“根据
Accept返回不同格式的数据”，就别用FileResult；改用ActionResult<T>+ 模型序列化，让框架接管协商流程 - 若必须返回文件（如导出 Excel/PDF），则
Accept失效是预期行为；此时应通过查询参数（如?format=json）或路由（/api/data.json）显式指定格式 - 手动设置
Content-Type时，注意它和Accept无关：return File(bytes, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
自定义类型无法被 JSON/XML 同时序列化
模型类里有 [XmlIgnore] 但没配 [JsonIgnore]，或用了 XmlRoot 却没加 JsonObject，就会导致一个格式能出，另一个报错或字段丢失。
实操建议：
- 优先用跨格式兼容的属性标记：
[JsonPropertyName("id")]+[XmlElement("id")]，而不是只写其中一个 - 避免依赖默认命名策略差异：JSON 默认 camelCase，XML 默认 PascalCase；统一用显式命名，或关掉 JSON 的
camelCase：options.JsonSerializerOptions.PropertyNamingPolicy = null;
- 集合类型慎用
IEnumerable<T>：XML 序列化器不支持直接序列化接口，需改为List<T>或加[XmlArray]
Content-Type 响应头没随 Accept 动态变化
即使协商成功，响应头里 Content-Type 仍是 application/json，哪怕客户端要的是 application/xml。这说明格式器没真正参与输出，或中间件顺序错了。
实操建议：
- 检查是否误用了
Ok(object)—— 它强制走 JSON；改用Ok<MyModel>(model)让泛型推导启用协商 - 确认没在 action 里手动调用
Json(model)或Xml(model)，这些方法绕过协商 - 如果用了
Produces特性，确保列出所有支持的类型：[Produces("application/json", "application/xml")]
内容协商真正起作用的前提，是整个链路都走 MVC 的序列化管道。一旦你手动构造响应体、用 FileStreamResult、或提前调用 Json()，Accept 就只是个 HTTP 头而已，没人会看它。
