Oracle 19c VARCHAR2列长度足够 插入ASCII值仍报值过大异常

异常场景 #

对接Oracle 19c企业版的Java/Spring系统调用存储过程时抛出如下异常：

database.org.springframework.jdbc.UncategorizedSQLException: CallableStatementCallback; 
uncategorized SQLException for SQL [{? = call booking_system_pkg.create_booking(?, ?, ?)}]; 
SQL state [99999]; error code [17072]; 
Inserted value too large for column: "E2BF85FFF1DFAB55E05329CC1C0A850E"; 
nested exception is java.sql.SQLException: Inserted value too large for column: 
"E2BF85FFF1DFAB55E05329CC1C0A850E"

已核查目标表字段类型为varchar2(60)，待插入值E2BF85FFF1DFAB55E05329CC1C0A850E为纯ASCII字符串，长度仅32，按字段定义本应可正常存入。

核心产生原因 #

这类问题90%以上不是表字段长度不足导致，常见触发点如下：

• 存储过程入参长度限制：报错由CallableStatement调用存储过程触发，绝大多数开发者只核查目标表字段长度，漏查包内存储过程的形参定义。如果对应入参声明的varchar2长度小于传入值长度，JDBC驱动在参数绑定阶段就会直接抛17072错误，请求根本不会进入存储过程执行逻辑。
• VARCHAR2长度语义/字符集不匹配：Oracle VARCHAR2支持字节、字符两种长度语义，默认varchar2(60)等价于varchar2(60 byte)。如果JDBC连接配置了oracle.jdbc.defaultNChar=true，驱动会把普通字符串按NVARCHAR2（AL16UTF16编码）做长度校验，纯ASCII字符在该编码下每个字符占2字节，若参数定义长度不足就会触发超长报错；部分老版本驱动还存在字符集转换时字节长度计算错误的bug。
• JDBC驱动版本bug：19.3之前的ojdbc8版本存在已知的存储过程参数长度校验bug，当开启自动提交、未手动指定参数类型时，驱动会误判纯ASCII字符串的字节长度，错误抛出值过大异常。
• 存储过程内部隐式转换：如果存储过程内部对传入参数做了类型转换（比如转RAW、加解密、拼接前后缀），实际插入表字段的值是转换后的更长内容，报错信息里打印的只是传入的原始参数值，不是最终执行插入的内容。

可行排查步骤 #

• 优先核查存储过程入参定义，执行以下SQL查询对应入参的实际长度配置，不要仅核对表字段：

SELECT argument_name, data_type, data_length, char_length, char_used
FROM all_arguments
WHERE owner = '当前业务schema用户名'
  AND package_name = 'BOOKING_SYSTEM_PKG'
  AND object_name = 'CREATE_BOOKING';

• 核查JDBC连接配置与驱动版本：检查连接参数中是否存在oracle.jdbc.defaultNChar=true、oracle.jdbc.convertNcharLiterals=true这类强制启用National Character Set的配置，将ojdbc8驱动升级至19.3及以上的匹配服务端版本。
• 校验是否为驱动侧校验问题：直接在PL/SQL客户端用相同参数手动调用目标存储过程，如果手动调用可以正常执行，仅JDBC调用报错，可直接锁定为驱动参数识别问题，调用存储过程时手动指定参数类型为Types.VARCHAR即可绕过自动识别错误，示例代码：

// 不要用setString让驱动自动识别类型，手动指定VARCHAR类型
cs.setObject(parameterIndex, "E2BF85FFF1DFAB55E05329CC1C0A850E", Types.VARCHAR);

• 排查存储过程内部逻辑：如果手动调用存储过程也报超长错误，在存储过程的插入逻辑前加调试输出，打印实际传入插入语句的字符串长度，确认是否存在隐式转换、值拼接导致内容变长的情况。
• 核查数据库长度语义配置：执行以下SQL确认数据库级长度语义配置，若为字节语义且存在多字节字符存储需求，可将字段/参数改为字符语义定义，比如varchar2(60 char)。

SELECT value FROM nls_database_parameters WHERE parameter = 'NLS_LENGTH_SEMANTICS';

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