Spring MVC如何从控制器传递数据库存储的图片到JSP页面展示

问题根源 #

• 核心问题是Spring MVC无法直接将Image类型对象转换为浏览器可识别的图片二进制流：你返回的Image是Java内置的对象类型，Spring默认的消息转换器不会把它处理成图片二进制，浏览器拿到的是Java对象序列化后的无效内容，自然无法渲染为图片。
• 缺少正确的响应头声明：浏览器需要通过Content-Type响应头识别返回内容是图片类型，没有正确配置的话浏览器会默认当成普通文本处理，不会触发图片渲染逻辑。

修复方案 #

直接将数据库读取到的原始图片字节数组作为响应返回，同时配置正确的响应头即可，修改后的Controller代码如下：

@RequestMapping(value = "/images/{imageid}", method = RequestMethod.GET)
public ResponseEntity<byte[]> getImage(@PathVariable String imageid) {
    // 读取数据库存储的原始图片字节
    byte[] imageBytes = imageService.get(Long.parseLong(imageid)).getData();
    
    HttpHeaders headers = new HttpHeaders();
    // 根据实际图片格式设置MIME类型，常见的有IMAGE_JPEG、IMAGE_PNG、IMAGE_GIF
    headers.setContentType(MediaType.IMAGE_JPEG);
    // 可选配置：添加缓存头，减少重复请求消耗
    headers.setCacheControl(CacheControl.maxAge(1, TimeUnit.HOURS).cachePublic());
    
    return new ResponseEntity<>(imageBytes, headers, HttpStatus.OK);
}

可选校验步骤 #

如果修改后还是无法正常显示，可以按顺序排查：

• 打开浏览器开发者工具的「网络」面板，检查/images/xxx请求的返回状态是否为200，响应头的Content-Type是否为正确的图片类型
• 确认数据库中存储的图片字节是完整未损坏的，可以先把字节数组输出到本地文件，确认能正常打开
• 如果你的业务支持多种图片格式，可以在存储图片时同步保存图片的MIME类型到数据库，查询时动态设置Content-Type即可适配所有格式。

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