Flux接口：Resolved [org.springframework.web.HttpMediaTypeNotAcceptableException: Could not find acceptable representation]

解决 Spring Web Flux 中 HttpMediaTypeNotAcceptableException 异常
当遇到 HttpMediaTypeNotAcceptableException 时，通常是因为客户端请求头中的 Accept 字段指定的内容类型不被服务器支持。为了处理这种情况，在配置 DispatcherServlet 的过程中需要注意内容协商机制的设置[^1]。
配置生产者端的支持媒体类型
确保应用程序能够响应多种可能的 Accept 头字段值。这可以通过自定义 WebFluxConfigurer 来实现：
@Configuration
public class WebConfig implements WebFluxConfigurer {

@Override
public void configureContentTypeResolver(RequestedContentTypeResolverBuilder builder) {
builder.fixedResolver(MediaType.APPLICATION_JSON);
}
}
登录后复制
上述代码指定了默认返回 JSON 格式的响应体。如果希望支持更多类型的媒体，则可以在 builder.fixedResolver() 方法调用中添加其他 MediaType 实例。
添加全局异常处理器
创建一个全局异常处理器来捕获并优雅地处理此类异常是非常重要的。可以利用 @ControllerAdvice 注解配合 @ExceptionHandler(HttpMediaTypeNotAcceptableException.class) 使用:
@ControllerAdvice
public class GlobalExceptionHandler {

@ExceptionHandler(HttpMediaTypeNotAcceptableException.class)
public Mono<ResponseEntity<String>> handleHttpMediaTypeNotAcceptable(
HttpMediaTypeNotAcceptableException ex) {

String errorMessage = "The requested resource is not available with the specified media type.";
return Mono.just(ResponseEntity.status(HttpStatus.NOT_ACCEPTABLE).body(errorMessage));
}
}
登录后复制
此方法会在发生 HttpMediaTypeNotAcceptableException 时向客户端发送带有适当状态码和消息的 HTTP 响应。
通过以上措施，应该能有效减少因不可接受的 MIME 类型而导致的服务错误，并提高 API 接口对于不同客户端需求的兼容性和健壮性。