YashanDB|如何配置 JDBC 驱动，让 getDatabaseProductName() 返回 Oracle?

在实际应用中，某些第三方组件(如工作流引擎 Activiti)目前尚未适配 YashanDB，导致在接入时遇到兼容性问题。本文将详细讲解原因及解决方法，帮助大家顺利接入。

一、问题现象

在使用 Activiti 等第三方组件时，程序启动时报错，无法正常连接 YashanDB 数据库。具体异常信息显示为：

无法识别数据库厂商 YashanDB，启动失败
二、问题风险与影响

导致 Activiti 引擎无法正常启动;

影响相关业务系统上线，阻断功能流转。

三、影响版本说明

此问题影响所有 YashanDB JDBC 驱动版本，直到新增支持项之前。

四、问题原因分析

Activiti 在启动时，会调用：

conn.getMetaData().getDatabaseProductName()

获取当前连接数据库的厂商信息。

如果返回的是 Activiti 认识的数据库(如 Oracle、MySQL)，则继续初始化;

如果返回的是未知数据库(如 YashanDB)，则抛出异常，导致启动失败。

从 Activiti 的源码可以看到，它内部的 databaseTypeMappings 列表中，并不包含 "YashanDB"：

databaseTypeMappings.put("oracle", "oracle");
databaseTypeMappings.put("mysql", "mysql");
// 没有 yashandb

所以默认无法支持 YashanDB。

五、解决方法与规避策略

从 YashanDB JDBC 1.7.1 版本开始，驱动连接串中新增了 productName 参数。

通过配置：

productName=Oracle
可以让 getDatabaseProductName() 返回值伪装成 "Oracle"，从而绕过 Activiti 对数据库厂商的严格校验。

连接串示例：

jdbc:yashandb://127.0.0.1:1688/testdb?productName=Oracle

这样，Activiti 启动时就会识别为 Oracle，顺利完成初始化。

六、问题分析与验证方法

如果想检测当前使用的 YashanDB JDBC 驱动是否支持 productName 参数，可以运行以下简单 Java 测试代码：

Connection conn = DriverManager.getConnection(...);
System.out.println(conn.getMetaData().getDatabaseProductName());
如果输出为 "Oracle"，说明已支持 productName 参数;

如果输出为 "YashanDB"，说明当前驱动版本尚不支持，需要升级。

七、经验总结

对接第三方组件时，要特别注意驱动兼容性;

合理利用 JDBC 驱动的 productName 选项，可以解决部分未适配问题;

建议使用 YashanDB JDBC 1.7.1 或更高版本，提升兼容性与稳定性。