Spring Data JPA插入Teradata数据时BYTE类型非法转换如何解决

问题原因 #

Teradata抛出的3532错误表示JDBC驱动将未知类型的参数作为BYTE类型传输，和表定义的字段类型不匹配，无法完成转换。你当前场景触发问题的核心原因是：
你在nativeQuery中使用SpEL表达式:#{#entity.xxx}绑定参数时，对于splitByBus、groupByBus、filterId这类允许为空的数字类型字段，如果传入值为null，驱动无法识别字段类型，默认按BYTE类型处理，直接触发类型转换非法的报错。

解决方案 #

方案一（推荐）：直接使用JPA自带的save方法 #

你已经正确配置了@Entity注解和ID主键生成策略，不需要自定义插入SQL，直接调用JpaRepository自带的save(JobQueue entity)方法即可。JPA会自动处理字段类型映射和空值的类型绑定，同时原生兼容Teradata的自增主键逻辑。

方案二：修改自定义SQL的参数绑定方式 #

如果你因为要加锁表逻辑必须使用自定义nativeQuery，可以把SpEL实体参数绑定改为显式的单个命名参数绑定，明确指定每个参数的类型：

@Modifying
@Query(value = "LOCKING TABLE JOB_QUEUE FOR WRITE INSERT INTO JOB_QUEUE (FILE_GUID, FILE_TYPE, PIPELINE_NAME, STATE, PRIORITY, DATE_CREATED, REQUEST_USER_ID, SPLIT_BY_BUS, FILTER_ID, GROUP_BY_BUS, RULE_SET, MAP_ID, OUTPUT_PATH, IS_REPLAY, SUBSCRIBING_PARTNER) VALUES (:fileGuid, :fileType, :pipelineName, :state, :priority, :dateCreated, :requestUserId, :splitByBus, :filterId, :groupByBus, :ruleSet, :mapId, :outputPath, :isReplay, :subscribingPartner)", nativeQuery = true)
void saveJobQueue(@Param("fileGuid") String fileGuid,
                  @Param("fileType") String fileType,
                  @Param("pipelineName") String pipelineName,
                  @Param("state") String state,
                  @Param("priority") Integer priority,
                  @Param("dateCreated") Timestamp dateCreated,
                  @Param("requestUserId") String requestUserId,
                  @Param("splitByBus") BigDecimal splitByBus,
                  @Param("filterId") Long filterId,
                  @Param("groupByBus") BigDecimal groupByBus,
                  @Param("ruleSet") String ruleSet,
                  @Param("mapId") Integer mapId,
                  @Param("outputPath") String outputPath,
                  @Param("isReplay") BigDecimal isReplay,
                  @Param("subscribingPartner") String subscribingPartner);

调用方法时传入JobQueue实体对应的字段值即可，显式声明参数类型后，就算传入空值也会按声明的类型传输，不会被驱动识别为BYTE类型。

方案三：保留SpEL绑定，显式指定空值类型 #

如果你一定要用SpEL绑定整个实体参数，可以在SQL中对允许为空的数字类型字段显式指定空值的类型：

-- 示例：把空的BigDecimal类型字段指定为DECIMAL类型
COALESCE(:#{#entity.splitByBus}, CAST(NULL AS DECIMAL))

所有允许为空的数字类型字段都做相同处理，明确空值类型后即可避免类型转换错误。

优化建议 #

你表中SPLIT_BY_BUS、GROUP_BY_BUS、IS_REPLAY三个字段都是NUMBER(1,0)类型，实际是布尔标记位，可以把实体类中对应的字段类型从BigDecimal改为Boolean，JPA会自动映射为0/1值，减少后续类型转换出错的概率。

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