Spring Boot多MediaType返回图片时Content-Type错误问题

• 核心问题是BufferedImage对象本身只存储内存中的像素矩阵数据，完全不携带原图片的格式、编码、色彩空间元信息，BufferedImageHttpMessageConverter无法从返回值判断应该输出哪种格式的图片。
• 你在@GetMapping的produces中同时声明了三种图片类型，Spring做内容协商时没有额外格式标识的情况下，会默认选择列表中排在第一位的image/jpeg作为响应Content-Type，固定调用JPEG编码器输出图片。
• PNG、GIF格式普遍支持透明通道，对应解码出来的BufferedImage是ARGB色彩空间，而JPEG编码器只支持RGB色彩空间，强行编码就会抛出Bogus input colorspace异常。
• 你注册转换器的方式也存在优先级问题：extendMessageConverters方法默认把新转换器追加到列表末尾，SpringMVC按顺序遍历匹配转换器时，默认注册的资源处理器会优先命中，你手动添加的转换器可能根本不会生效。

根据业务场景二选一即可：

方案1：直接输出原文件流（最稳妥、性能最高） #

如果不需要对图片做裁剪、加水印等二次处理，完全没必要经过ImageIO解码再编码，直接识别文件后缀设置正确的Content-Type，把文件流拷贝到响应即可，彻底避免编解码带来的格式、色彩空间问题：

@RestController
@RequestMapping("/image")
public class ImageController {
    @CrossOrigin(origins = "*")
    @GetMapping(value = "/thumb/{bookId}")
    public void getThumb(@PathVariable("bookId") long bookId, HttpServletResponse response) throws IOException {
        String imagePath = imageMapper.findThumbPathById(bookId);
        File imageFile = new File(imagePath);
        // 识别后缀设置对应Content-Type
        String fileExt = getFileExtension(imageFile.getName()).toLowerCase(Locale.ROOT);
        String contentType = switch (fileExt) {
            case "png" -> MediaType.IMAGE_PNG_VALUE;
            case "gif" -> MediaType.IMAGE_GIF_VALUE;
            default -> MediaType.IMAGE_JPEG_VALUE;
        };
        response.setContentType(contentType);
        // 流直接拷贝，不做编解码
        try (FileInputStream fis = new FileInputStream(imageFile);
             ServletOutputStream os = response.getOutputStream()) {
            fis.transferTo(os);
            os.flush();
        }
    }

    // 自己实现后缀获取，不需要额外依赖第三方工具包
    private String getFileExtension(String fileName) {
        int dotIndex = fileName.lastIndexOf('.');
        return dotIndex == -1 ? "" : fileName.substring(dotIndex + 1);
    }
}

方案2：需要二次处理图片时手动指定输出格式 #

如果确实需要对读取的BufferedImage做二次加工，首先调整转换器注册顺序，把BufferedImageHttpMessageConverter放到转换器列表最前面保证优先命中，然后在接口中手动根据原图片格式设置响应Content-Type：

1. 修改WebMVC配置：

@Configuration
public class WebMVCConfigurer implements WebMvcConfigurer {
    @Override
    public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
        // 转换器加到列表头部，提升匹配优先级
        converters.add(0, new BufferedImageHttpMessageConverter());
    }
}

2. 接口中手动设置正确的Content-Type：

@CrossOrigin(origins = "*")
@GetMapping(value = "/thumb/{bookId}", produces = {MediaType.IMAGE_JPEG_VALUE, MediaType.IMAGE_GIF_VALUE, MediaType.IMAGE_PNG_VALUE})
public BufferedImage getThumb(@PathVariable("bookId") long bookId, HttpServletResponse response) throws IOException {
    String imagePath = imageMapper.findThumbPathById(bookId);
    File imageFile = new File(imagePath);
    String fileExt = getFileExtension(imageFile.getName()).toLowerCase(Locale.ROOT);
    // 提前设置正确的响应类型，转换器会自动匹配对应编码器
    if ("png".equals(fileExt)) {
        response.setContentType(MediaType.IMAGE_PNG_VALUE);
    } else if ("gif".equals(fileExt)) {
        response.setContentType(MediaType.IMAGE_GIF_VALUE);
    } else {
        response.setContentType(MediaType.IMAGE_JPEG_VALUE);
    }
    BufferedImage image = ImageIO.read(imageFile);
    // 这里可以添加图片处理逻辑：裁剪、加水印、压缩等
    return image;
}

注意：如果处理后的图片保留了ARGB透明通道，又需要输出为JPEG格式，必须先把BufferedImage转为RGB色彩空间去掉透明层，否则依然会触发色彩空间异常。

内容的提问来源于stack exchange，提问作者NikR_Qin