SQL Server中char(1)主键表用jTDS驱动更新报错的解决方法

我之前在项目里也碰到过一模一样的问题——用jTDS驱动更新SQL Server中主键为char(1)类型的表时，总是莫名其妙报错或者更新不到记录。后来排查发现，核心原因是jTDS对char类型参数的默认处理和SQL Server的char类型存储特性不兼容，下面是几个亲测有效的解决办法：

1. 绑定参数时明确指定SQL类型为CHAR #

jTDS默认会把字符串参数推断为VARCHAR类型，但SQL Server的char(1)是固定长度的字符类型，两者在匹配主键时可能因为排序规则或类型校验失败。我们可以在设置参数时显式指定类型：

String updateSql = "UPDATE your_table SET column_name = ? WHERE primary_key_col = ?";
PreparedStatement pstmt = connection.prepareStatement(updateSql);

// 设置普通字段值
pstmt.setString(1, "updated_value");
// 关键：明确指定主键参数为CHAR类型，长度1
pstmt.setObject(2, "A", java.sql.Types.CHAR, 1);

pstmt.executeUpdate();

2. 在SQL语句中显式转换参数类型 #

如果不想修改Java代码的参数绑定逻辑，可以直接在SQL里把参数转成char(1)类型，让SQL Server自己处理类型匹配：

UPDATE your_table 
SET column_name = ? 
WHERE primary_key_col = CAST(? AS CHAR(1))

这种方式简单直接，不需要改动Java代码，适合快速修复问题。

3. 检查并修正主键参数的格式 #

有时候问题出在参数本身：

• 如果你的主键值是空字符串，要替换成单个空格（因为SQL Server的char(1)空值会自动补空格存储）；
• 如果传入的主键值长度超过1，要截断到第一位，比如用idValue.substring(0, 1)确保长度符合要求；
• 避免传入带有不可见字符的字符串，比如换行符、制表符，这些会导致主键匹配失败。

4. 升级jTDS驱动到最新版本 #

老版本的jTDS（比如1.3.x之前的版本）在处理SQL Server的char类型参数时存在已知bug，升级到最新稳定版（比如1.3.2或更高）可能直接解决这个问题。

内容的提问来源于stack exchange，提问作者Felipe j.lemos