YashanDB知识库|Quartz调度写布尔值报错?问题关键在于 true/false 与 0/1 的差异

【问题分类】驱动兼容性 / 第三方框架集成

【关键词】Quartz、JDBC、布尔值、varchar(1)、Boolean写入异常

一、问题现象

在将开源任务调度框架 Quartz 与 YashanDB 数据库集成时，执行如下写入语句时发生异常：

ps.setBoolean(5. job.isDurable());

报错信息如下：

YAS-04008 IS_DURABLE size exceeding limit 1

这个错误在 Oracle 中从未出现过，却在 YashanDB 中触发了字段写入限制。

二、问题背景与影响

Quartz 框架广泛应用于企业中定时任务调度系统，其数据库模型中使用大量布尔字段记录任务状态，如：

是否持久化(is_durable)

是否并发执行(is_nonconcurrent)

是否已暂停(is_paused)

这些字段在数据库中通常定义为 varchar(1) 类型，并通过 setBoolean() 或 setObject() 写入。

在 Oracle 中，布尔值通常转化为 0 或 1.正好符合 varchar(1) 的长度要求。而在 YashanDB 中，默认将布尔值写为 true 或 false 字符串，因此长度超限，触发报错。

三、影响范围

影响数据库版本：YashanDB 23.2.0.12 及以下

涉及框架：Quartz、以及其他类似写法的调度平台

风险等级：中等(不会影响所有 SQL，但核心调度模块写入失败将阻断任务执行)

四、具体原因分析

因此，问题根源并不是 Quartz 的代码错误，而是 YashanDB 与 Oracle 在 JDBC 写入布尔值的默认行为存在差异。

五、可选规避方式

方案一：修改代码，布尔值转为整数

ps.setInt(1. boolValue ? 1 : 0);
优点：可兼容 Oracle / YashanDB

缺点：需修改 Quartz 源码，开发与维护成本高，不适合通用场景

方案二：扩展字段长度

将数据库中 varchar(1) 字段改为 varchar(5) 或更长，以容纳 “true”/“false” 字符串

优点：操作简单，绕过长度限制

缺点：影响读取判断逻辑，部分组件可能因识别错误导致调度逻辑异常

方案三（推荐）：修改字段类型为 boolean

将 is_xxx 类布尔字段由 varchar(1) 修改为 boolean 类型，完全契合 YashanDB 的布尔类型支持：

已有客户验证可正常使用

写入与判断逻辑都保持一致

注意：适用于单库部署，若仍需兼容 Oracle，则需另做处理

六、官方修复情况

在 YashanDB 23.2.0.33 及以上版本，JDBC 驱动已调整：

默认行为与 Oracle 保持一致，布尔值写入时自动转为 0 / 1.避免因 varchar(1) 长度限制报错。

相关优化参考需求：JDBC 驱动布尔值写入 Oracle 一致性兼容优化

七、总结建议