spring boot 全局异常处理可以通过配置 @controlleradvice 捕获 cookie 解析异常，具体做法是拦截 illegalargumentexception 或 cookienamenotfoundexception。当 spring mvc 尝试从请求中读取 cookie 但发生格式错误或找不到指定名称时，会抛出这些异常，在全局处理器中统一返回 json 错误响应即可。
@CookieValue 解析失败时抛出什么异常
当使用 @CookieValue 注解且 Cookie 不存在或格式非法时，默认会抛出 MissingRequestCookieException（继承自 MissingServletRequestParameterException）或 IllegalArgumentException。如果配置了 required=false 但未找到 Cookie，则值为 null；若找到但无法转换类型，则抛出 MethodArgumentTypeMismatchException。全局异常处理器应优先捕获 MissingRequestCookieException 以处理缺失情况，捕获 IllegalArgumentException 以处理格式问题。
import org.springframework.web.bind.annotation.*;
import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
import org.springframework.web.servlet.mvc.method.annotation.ResponseEntityExceptionHandler;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler extends ResponseEntityExceptionHandler {
@ExceptionHandler(MissingRequestCookieException.class)
public ResponseEntity<Map<String, String>> handleMissingCookie(MissingRequestCookieException ex) {
Map<String, String> error = new HashMap<>();
error.put("error", "Cookie missing");
error.put("message", ex.getMessage());
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(error);
}
@ExceptionHandler(IllegalArgumentException.class)
public ResponseEntity<Map<String, String>> handleIllegalArg(IllegalArgumentException ex) {
if (ex.getMessage() != null && ex.getMessage().contains("cookie")) {
Map<String, String> error = new HashMap<>();
error.put("error", "Invalid cookie format");
error.put("message", ex.getMessage());
return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(error);
}
throw ex;
}
}
如何自定义 Cookie 验证逻辑并避免异常
为避免依赖框架抛出的异常，可以在 Controller 方法中手动获取 Cookie 对象并进行验证。通过注入 HttpServletRequest 或使用 @RequestHeader("Cookie") 获取原始 Cookie 字符串，再使用 jakarta.servlet.http.Cookie 工具类解析。这种方式允许在异常发生前进行空值检查和格式校验，从而提供更清晰的错误提示。
import org.springframework.web.bind.annotation.*;
import jakarta.servlet.http.Cookie;
import jakarta.servlet.http.HttpServletRequest;
import org.springframework.http.ResponseEntity;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;
@RestController
public class CookieController {
@GetMapping("/validate-cookie")
public ResponseEntity<Map<String, String>> validateCookie(HttpServletRequest request) {
Map<String, String> result = new HashMap<>();
Cookie[] cookies = request.getCookies();
if (cookies == null) {
result.put("status", "no-cookies");
return ResponseEntity.ok(result);
}
for (Cookie cookie : cookies) {
if ("session_id".equals(cookie.getName())) {
if (cookie.getValue() == null || cookie.getValue().isEmpty()) {
result.put("status", "invalid-session");
result.put("message", "Session ID is empty");
return ResponseEntity.badRequest().body(result);
}
result.put("status", "valid");
result.put("session_id", cookie.getValue());
return ResponseEntity.ok(result);
}
}
result.put("status", "missing-session");
result.put("message", "Session ID cookie not found");
return ResponseEntity.status(HttpStatus.NOT_FOUND).body(result);
}
}
当 Cookie 值为空字符串时全局异常处理器会捕获吗
当 Cookie 值为空字符串时，Spring MVC 不会抛出异常，因为空字符串是合法的 Cookie 值。此时 @CookieValue 会成功绑定为空字符串，而不会触发 MissingRequestCookieException 或 IllegalArgumentException。因此，全局异常处理器无法捕获这种情况，必须在业务逻辑中显式检查空值。例如，在 Controller 方法中添加 if (cookieValue.isEmpty()) 判断，以区分“未提供 Cookie”和“提供空值”两种场景。
