Java Spring MVC 怎么通过内容协商机制根据请求头返回不同格式数据-java教程-PHP中文网

spring mvc 通过内容协商机制自动根据 accept 请求头选择 json 或 xml 等响应格式，依赖 contentnegotiationmanager 和 httpmessageconverter，需配置 jackson 依赖、禁用 ignoreacceptheader 并避免 produces 硬编码。

java spring mvc 怎么通过内容协商机制根据请求头返回不同格式数据

Spring MVC 通过内容协商（Content Negotiation）机制，自动根据客户端请求头中的 Accept 字段选择返回 JSON、XML 或其他格式的数据。这个过程不需要手动判断或分支编码，而是由框架内部的 ContentNegotiationManager 和 HttpMessageConverter 协同完成。

核心原理是自动匹配媒体类型

当客户端发起请求时，比如用 Postman 设置 Accept: application/json，Spring MVC 会解析该头，确定目标媒体类型为 application/json；接着查找能处理该类型的 HttpMessageConverter（如 MappingJackson2HttpMessageConverter），再将 Controller 返回的 Java 对象序列化为 JSON 响应体。

关键前提是：

redis-tools

按类别查找Redis命令、检测服务器连接、监控键数量和内存占用，支持离线速查表。

下载

方法上标注了 @ResponseBody 或类上用了 @RestController
项目中已引入对应的消息转换器依赖（如 Jackson 处理 JSON，Jackson XML 处理 XML）
Spring Boot 默认启用基于请求头的内容协商策略（HeaderContentNegotiationStrategy）

需要确保的三项配置

引入必要依赖

JSON 支持：spring-boot-starter-web 默认包含 Jackson

XML 支持：额外添加 jackson-dataformat-xml

<dependency><groupid>com.fasterxml.jackson.dataformat</groupid><artifactid>jackson-dataformat-xml</artifactid></dependency>

确认 Accept 头未被忽略
默认行为是尊重 Accept 头。若在配置中误设 ignoreAcceptHeader: true，协商将失效。建议显式关闭忽略：
```
spring:
  mvc:
    contentnegotiation:
      ignore-accept-header: false
```
Controller 方法不锁定 produces 类型
避免在 @GetMapping 中写死 produces = "application/json"，否则会强制只返回 JSON，绕过协商。保持方法开放，让框架按需选择：
```
@GetMapping("/users/{id}")
public User getUser(@PathVariable Long id) {
    return userService.findById(id);
}
```

实际请求示例与响应效果

客户端请求方式	`Accept` 头值	Spring MVC 响应格式
浏览器直接访问	`text/html,application/xhtml+xml,...`	默认 fallback 到 JSON（因无 HTML 视图）
`curl -H "Accept: application/json" /api/users/1`	`application/json`	返回 JSON（如 `{"id":1,"name":"张三"}`）
`curl -H "Accept: application/xml" /api/users/1`	`application/xml`	返回 XML（如 `<user><id>1</id><name>张三</name></user>`）
`curl -H "Accept: application/json, application/xml;q=0.9" /api/users/1`	权重优先 JSON	仍返回 JSON