Spring Boot整合Flyway迁移MariaDB时如何优雅插入MEDIUMBLOB图片

核心思路是放弃纯SQL脚本硬编码二进制数据的方式，改用Flyway原生支持的Java迁移能力实现文件读取与数据插入，图片资源独立存放，维护成本远低于硬编码方案。

具体实现步骤 #

• 调整资源目录结构，将待插入的图片与SQL脚本拆分存放，避免二进制文件污染SQL目录：

resources
├── db
│   └── migration
│       ├── V2__init.sql
│       └── V3__InsertImageData.java
└── seeds
    └── target_image.jpg

原有V2__init.sql建表脚本无需改动，直接保留即可；删除原来写死二进制的V3__insert_table_data.sql，避免版本冲突。

• 编写Java迁移类，类名严格遵循Flyway版本命名规则：V<版本号>__<描述>.java，通过JDBC流读取本地图片写入MEDIUMBLOB字段，示例代码如下：

package com.your.project.db.migration;

import org.flywaydb.core.api.migration.BaseJavaMigration;
import org.flywaydb.core.api.migration.Context;
import org.springframework.core.io.ClassPathResource;
import java.io.InputStream;
import java.sql.PreparedStatement;

public class V3__InsertImageData extends BaseJavaMigration {
    @Override
    public void migrate(Context context) throws Exception {
        // 读取classpath下的图片资源
        ClassPathResource imageFile = new ClassPathResource("seeds/target_image.jpg");
        try (
            InputStream imageIs = imageFile.getInputStream();
            PreparedStatement statement = context.getConnection()
                    .prepareStatement("INSERT INTO table_name(id, image) VALUES (?, ?)")
        ) {
            statement.setString(1, "some_id");
            // 直接传入二进制流写入BLOB字段，无需手动转义编码
            statement.setBinaryStream(2, imageIs, (int) imageFile.contentLength());
            statement.executeUpdate();
        }
    }
}

• 多图片批量插入时，只需在migrate方法内循环读取seeds目录下的所有图片文件，按规则设置id参数批量执行插入即可。

注意：Spring Boot默认会扫描启动类所在包及其子包下的db/migration路径识别Java迁移类，如果你的迁移类放在其他包路径下，需要在配置文件中添加spring.flyway.locations=classpath:db/migration,classpath:com/your/project/db/migration指定扫描位置，避免迁移类不生效。

方案优势 #

• 无大体积SQL文件，图片替换直接覆盖seeds目录下的资源即可，版本管理时不会出现无意义的超长二进制字符串diff，代码评审、问题排查效率更高
• 不存在纯SQL插入二进制时的字符转义、编码不匹配问题，不会出现插入后图片损坏无法读取的情况
• 无需修改MariaDB服务端配置，兼容所有部署环境，迁移执行逻辑和应用绑定，不会因为数据库配置差异导致迁移失败

不推荐的替代方案 #

可以使用MariaDB自带的LOAD_FILE()函数在SQL中直接读取服务器本地文件插入，但该方案需要修改数据库secure_file_priv配置、要求图片必须存放在数据库服务器的指定绝对路径下，生产环境限制多、部署兼容性差，除非特殊场景否则不建议使用。

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