ora-01461主因是jdbc驱动在2000–4000字节区间误将string归为long类型，非数据真超限；需验证字节数、字段data_length、驱动版本（推荐ojdbc8 21.7.0.0），并显式设置参数类型。
先确认是不是真超长，还是驱动“猜错了”
ORA-01461 的本质不是数据一定越界，而是 Oracle JDBC 驱动在参数长度处于 2000–4000 字节区间时，对 String 类型的绑定值自动归类为 LONG ——哪怕目标列是 VARCHAR2(4000) 或 CLOB。这种误判在批量插入、INSERT ... SELECT ? FROM DUAL、或使用 addBatch() 时尤其高频。
验证方法很简单：
- 查实际字节数：
SELECT LENGTHB('你的字符串') FROM DUAL，别信length()（它返回字符数） - 查字段定义：
SELECT data_type, char_length, data_length FROM all_tab_columns WHERE table_name = 'YOUR_TABLE' AND column_name = 'YOUR_COLUMN' - 如果
data_type是VARCHAR2且data_length是 4000（AL32UTF8 下对应约 1333 个中文），而你的字符串字节数在 2000–4000 之间，那大概率是驱动误判，不是真超限
ojdbc 版本是关键开关，别迷信“新就是好”
Oracle 官方驱动对这个区间的处理逻辑在不同版本间反复变动。比如 ojdbc11（Spring Boot 3.2 默认）在批量场景下就比 ojdbc8 21.7.0.0 更容易触发 ORA-01461，哪怕数据完全合法。
实操建议：
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 优先降级到
ojdbc8 21.7.0.0或ojdbc8 19.22.0.0，这两个版本对 2000–4000 字节区间的稳定性经过大量生产验证 - 避免混用：项目中不要同时存在
ojdbc6和ojdbc11，类加载冲突会加剧类型推断混乱 - 检查依赖树：
mvn dependency:tree | grep ojdbc，确认 runtime 真正加载的是哪个 jar
显式声明参数类型，绕过驱动自动推断
靠 setString() 或 addBatch() 让驱动自己猜类型，等于把问题交给黑盒。必须主动控制：
- 对 CLOB 字段：用
setClob()或setCharacterStream()，不要用setString() - 用
OraclePreparedStatement时，显式调用setOracleObject("param", clobValue, OracleType.CLOB) - 禁用
addBatch()中的自动类型识别：改用循环 +executeUpdate()，虽然慢一点，但能快速定位是否是批量机制本身的问题 - 绝对不用
addBatch()+addWithValue()组合——这是 ORA-01461 的高发温床
别忽略 MAX_STRING_SIZE 和字符集的连锁反应
即使你用了 CLOB，如果数据库启用了 MAX_STRING_SIZE=EXTENDED，但表结构没重建，或者字符集是 AL32UTF8，VARCHAR2(32767) 实际仍受限于底层存储块，某些驱动版本会回退到 LONG 模拟逻辑。
检查和应对：
- 运行
SELECT name, value FROM v$parameter WHERE name = 'max_string_size'，若为STANDARD，说明VARCHAR2顶格仍是 4000 字节，别被建表语句里的(32767)迷惑 - AL32UTF8 下，一个汉字占 3 字节，所以
VARCHAR2(4000)最多存 1333 个汉字；若业务文本平均含 1500 字中文，直接建 CLOB，别硬撑 -
ALTER SYSTEM SET MAX_STRING_SIZE=EXTENDED后必须重启实例，且需执行@?/rdbms/admin/utl32k.sql，漏掉任一环节都会让扩展失效
最常被跳过的点：错误日志里出现 ORA-01461 时，第一反应总去查数据长度，但真正要盯住的是 JDBC 驱动版本 + 参数绑定方式 + 字段实际 data_length 三者的组合态。单点排查容易来回折腾。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
