Java JDBC调用setNull插入MySQL int列触发BatchUpdateException错误

问题原因 #

这个问题是MySQL 5.x版本JDBC驱动（mysql-connector-java）的已知兼容性问题：驱动在处理Types.INTEGER类型的null值时，会错误将其序列化为空字符串''传递到MySQL服务端。如果你的服务端开启了严格SQL模式（默认包含STRICT_TRANS_TABLES配置），就无法将空字符串隐式转换为int类型的null，直接抛出你遇到的报错。Float类型的null处理逻辑在驱动中单独做了适配，所以不会触发该问题。

解决方案 #

方案1：调整赋值写法（改造成本最低，无需修改依赖/服务端配置） #

将原有setNull调用替换为setObject即可，两种可行写法：

// 明确指定字段类型为INTEGER，传入null对象
stmt.setObject(1, null, Types.INTEGER);

// 高版本驱动也可以直接传入null，会自动匹配表字段类型
stmt.setObject(1, null);

方案2：升级JDBC驱动版本 #

将mysql-connector-java升级到8.0及以上版本，该版本已经修复了int类型null的序列化bug，原有stmt.setNull(1, Types.INTEGER)写法可以直接正常运行。
注意升级后连接URL需要适配新格式，建议补充时区参数避免时间处理异常，示例：
jdbc:mysql://127.0.0.1:3306/库名?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai

方案3：调整服务端SQL模式（不推荐） #

如果不方便修改代码和依赖，可以临时移除MySQL sql_mode中的STRICT_TRANS_TABLES配置，服务端会自动将空字符串转换为对应int值。但该方案会降低数据校验严格性，容易引发隐性数据错误，不建议生产环境使用。

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