Java JDBC MySQL 中执行多条 INSERT 语句的正确配置方法

jdbc 默认禁止单次执行多条 sql 语句，需在 mysql 连接 url 中显式启用 `allowmultiqueries=true` 参数，方可支持分号分隔的批量 insert（如 `insert ...; insert ...;`）。

在使用 JDBC 操作 MySQL 时，即使 SQL 语句在 MySQL Workbench 中能成功执行多条 INSERT（以分号分隔），通过 PreparedStatement.executeUpdate() 调用仍会报语法错误——这是因为 MySQL JDBC 驱动（Connector/J）默认关闭了多语句执行功能，以防止 SQL 注入等安全风险。

✅ 正确解决方案：在数据库连接 URL 中添加 allowMultiQueries=true 参数。例如：

String url = "jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC&allowMultiQueries=true";
Connection conn = DriverManager.getConnection(url, username, password);

⚠️ 注意事项：

• 该参数仅对 Statement 和 CallableStatement 生效；PreparedStatement 不支持多语句（即使启用了 allowMultiQueries=true，调用 prepareStatement(sql) 传入含多个语句的字符串仍会抛出 SQLSyntaxErrorException）。因此，应改用 Statement：

  

  Word-As-Image for Semantic Typography

  文字变形艺术字、文字变形象形字

  下载

  立即学习“Java免费学习笔记（深入）”；

  Statement stmt = conn.createStatement();
  String sql = "INSERT INTO subscriptions(...) VALUES (...); " +
               "INSERT INTO contact_informations(...) VALUES (...);";
  int[] results = stmt.executeBatch(); // 或使用 executeUpdate() 执行首条，但推荐 executeBatch()

• 更推荐的生产实践是使用 批处理（Batch Processing），它更安全、高效且兼容性更好：

  PreparedStatement ps = conn.prepareStatement(
      "INSERT INTO subscriptions(user_id, `status`, subscription_type, ...) VALUES (?, ?, ?, ...)"
  );
  ps.setInt(1, 18); ps.setString(2, "ACCEPTED"); /* ... */ ps.addBatch();
  
  ps = conn.prepareStatement(
      "INSERT INTO contact_informations(user_id, email, ...) VALUES (?, ?, ...)"
  );
  ps.setInt(1, 18); ps.setString(2, "user@example.com"); /* ... */ ps.addBatch();
  
  int[] counts = ps.executeBatch(); // 一次网络往返，事务内原子执行

? 总结：
allowMultiQueries=true 是解决“多语句单执行”的快捷方式，但仅适用于 Statement，且存在安全与可维护性隐患；在绝大多数场景下，应优先采用 addBatch() + executeBatch() 实现高效、安全、标准的批量插入。