Spring JPA上传图片存MySQL BLOB时imgSrc字段未保存问题

图片二进制数据无法入库是三个配置错误共同导致的：

• 前端文件上传表单缺少必填的enctype="multipart/form-data"属性，默认表单编码格式application/x-www-form-urlencoded仅支持传输文本键值对，无法携带二进制文件内容，后端根本收不到上传的文件流。
• 实体类二进制字段的列配置错误：columnDefinition = "bytea"是PostgreSQL数据库的二进制类型语法，不适用于MySQL，会导致JPA字段映射异常。
• 数据绑定逻辑缺失：Spring MVC不会自动把表单提交的文件流转换为byte[]赋值给实体类字段，直接用实体类接收时文件字段默认是null。

1. 修正前端表单配置 #

文件上传表单必须添加enctype="multipart/form-data"属性，同时不要将文件输入框直接绑定实体的byte[]字段，单独定义文件参数名接收上传内容，修正后代码：

<form action="#" th:action="@{/add}" th:object="${option}"  method="post" enctype="multipart/form-data">
    <div class="modal-body">
        <div class="form-group">
            <input type="hidden" th:field="*{id}" class="form-control">
        </div>
        <div class="form-group">
            <label>Description</label>
            <input type="text" th:field="*{imgDesc}" class="form-control" required>
        </div>
        <div class="form-group">
            <label>Image name</label>
            <input type="text" th:field="*{imgName}" class="form-control" required>
        </div>
        <div  class="form-group">
            <label class="form-label" >Upload image</label>
            <input type="file" name="imgFile" class="form-control" accept="image/*" />
        </div>
    </div>
    <div class="modal-footer">
        <a href="/admin" class="btn btn-info" role="button">Cancel</a>
        <input type="submit" class="btn btn-success" value="Save">
    </div>
</form>

2. 修正JPA实体类字段映射 #

将二进制字段的列定义替换为MySQL支持的BLOB类型，可根据存储的图片大小选择对应类型：

• TINYBLOB：最大255字节，不适合存图片
• BLOB：最大65KB，适合存极小的图标
• MEDIUMBLOB：最大16MB，满足绝大多数普通图片存储需求
• LONGBLOB：最大4GB，适合存大尺寸原图

修正后的字段注解如下，其余实体代码无需改动：

@Lob
@Column(name="img_src", columnDefinition = "MEDIUMBLOB")
private byte[] imgSrc;

注意：不要在JPA实体类中定义MultipartFile类型的字段，这类Web请求参数不要和持久化实体耦合。

3. 修正Controller层参数绑定逻辑 #

单独接收MultipartFile类型的文件参数，在方法内部手动将文件流转换为byte[]后赋值给实体字段，修正后代码：

@PostMapping("/add")
public String addOption(@ModelAttribute("option") Option option, 
                        @RequestParam("imgFile") MultipartFile imgFile) throws IOException {
    if (!imgFile.isEmpty()) {
        // 将上传文件流转为byte数组赋值给实体字段
        option.setImgSrc(imgFile.getBytes());
        // 前端未传入文件名时默认取上传文件原名
        if (option.getImgName() == null || option.getImgName().isBlank()) {
            option.setImgName(imgFile.getOriginalFilename());
        }
    }
    optionService.save(option);
    return "redirect:/admin";
}

4. 配置检查（可选） #

Spring Boot 2.x+版本默认已开启Multipart上传支持，如果上传时提示文件大小超限，可在application.properties中添加如下配置调整阈值：

# 单个上传文件最大10MB，单次请求总大小最大100MB，可按需调整
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=100MB
spring.servlet.multipart.enabled=true

• 保存完成后查询数据库，不要因为可视化工具查看BLOB字段显示乱码就判定存储失败，二进制字段在文本类视图下显示乱码是正常现象，可以通过字段长度判断是否写入成功。
• 图片回显时单独编写查询接口，读取对应记录的imgSrc字节数组，设置响应头Content-Type为对应图片格式，直接将字节流写入响应体即可正常展示图片。

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