在spring boot rest接口中设置请求头,最直接的方式是使用@requestheader注解将http请求头绑定到方法参数,或者通过httpservletrequest对象获取。若需向客户端返回自定义响应头,则应使用httpservletresponse或responseentity进行设置。以下代码演示了如何从请求中读取x-user-id头,并在响应中设置x-response-time头。

如何从请求中读取特定请求头
要读取请求头,可以在控制器方法的参数前添加@RequestHeader注解。该注解会自动解析HTTP请求中的指定头部字段并注入到参数中。如果请求中缺少该头部,可以通过设置required=false来避免抛出异常,此时参数值为null或默认值。

import org.springframework.web.bind.annotation.*;
@RestController
public class HeaderController {
@GetMapping("/read-header")
public String readHeader(
@RequestHeader(value = "X-Custom-Header", required = false, defaultValue = "default-value") String customHeader) {
return "Received: " + customHeader;
}
}
当发送GET请求到/read-header且包含X-Custom-Header: test-value时,返回结果为Received: test-value。若未提供该头,则返回Received: default-value。
如何向响应中添加自定义请求头
要向客户端返回自定义响应头,可以使用HttpServletResponse对象的addHeader方法,或者更推荐的方式是使用ResponseEntity构建器。使用ResponseEntity可以链式调用header()方法来设置多个头部,同时还能控制状态码和响应体,使代码更具声明性。

import org.springframework.http.*;
import org.springframework.web.bind.annotation.*;
@RestController
public class ResponseHeaderController {
@GetMapping("/write-header")
public ResponseEntity<string> writeHeader() {
return ResponseEntity.ok()
.header("X-Response-Time", "100ms")
.header("X-Server-Version", "1.0")
.body("Success");
}
}</string>
访问/write-header接口,客户端将收到状态码200,响应体为Success,同时包含X-Response-Time: 100ms和X-Server-Version: 1.0两个自定义响应头。
基于@RequestHeader注解处理缺失头部的具体行为
当使用@RequestHeader注解且未设置required=false时,如果请求中缺少指定的头部,Spring Boot会抛出MissingRequestHeaderException,导致400 Bad Request错误。这是默认的安全行为,确保关键头部存在。开发者应根据业务需求决定是否需要允许头部缺失,并通过defaultValue属性提供回退值,从而避免异常中断流程。











