Spring Boot使用JPA nativeQuery向MySQL批量插入列表报错如何解决

问题根因 #

你遇到的报错是因为JPA的参数绑定（:参数名写法）会将传入的字符串整体识别为单个字段值，自动添加引号和转义处理，不会将你拼接好的(15,2083),(15,2084)...当做SQL语法的一部分解析，最终执行的SQL会变成INSERT INTO 表名 VALUES '(你的整串values内容)'，不符合MySQL插入语法，所以触发语法错误。

可行解决方案 #

方案1：使用JPA自带的saveAll批量插入（最推荐，无SQL注入风险） #

这是Spring Data JPA原生支持的批量插入方案，无需手动写SQL：

1. 先在项目配置文件中开启Hibernate批量插入优化：

spring:
  jpa:
    properties:
      hibernate:
        jdbc:
          batch_size: 100 # 每次批量提交的条数，可按需调整
        order_inserts: true # 对插入语句排序，合并同表插入请求
        order_updates: true
    show-sql: true # 开启后可在控制台确认批量SQL是否生成

2. 调用Repository的saveAll方法传入实体对象列表即可：

// 你的实体类列表
List<你的实体类> entityList = 你要插入的数据列表;
repository.saveAll(entityList);

方案2：修改nativeQuery为SQL直接拼接（仅适合无外部输入的安全场景） #

如果你一定要用自己拼接的values串，需要将参数绑定的:改为SpEL的${}直接拼接SQL内容：

// 注意将原来的:listVal改为${listVal}
@Query(value = "INSERT INTO 你的表名(字段1, 字段2) VALUES ${listVal}", nativeQuery = true)
void batchInsert(@Param("listVal") String listVal);

注意：该写法有SQL注入风险，仅当你完全控制listVal的生成逻辑、没有用户输入参与时使用

方案3：使用NamedParameterJdbcTemplate实现安全的原生批量插入 #

如果需要写原生SQL又要避免SQL注入，推荐用JDBC模板的批量更新能力：

@Autowired
private NamedParameterJdbcTemplate jdbcTemplate;

public void batchInsert(List<你的数据类> dataList) {
    String sql = "INSERT INTO 你的表名(col1, col2) VALUES (:col1, :col2)";
    // 构造参数数组
    MapSqlParameterSource[] paramArr = dataList.stream()
            .map(data -> new MapSqlParameterSource()
                    .addValue("col1", data.getCol1())
                    .addValue("col2", data.getCol2()))
            .toArray(MapSqlParameterSource[]::new);
    jdbcTemplate.batchUpdate(sql, paramArr);
}

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