国产化信创改造：达梦/人大金仓适配与多数据库兼容方案实战（SpringBoot）

国产化信创改造达梦/人大金仓适配与多数据库兼容方案实战SpringBoot演示地址http://ruoyioffice.com | 源码1·GitHubruoyi-office | 源码2·GitCoderuoyi-office | 源码3·Giteeruoyi-office | 微信17156169080备注「RuoYi Office」政企、国资、金融、医疗的项目越来越多地写明国产化/信创要求数据库必须用达梦、人大金仓、OpenGauss 等国产库Oracle/MySQL 不再被接受。这时候原本跑在 MySQL 上的系统能不能换个数据库就跑就成了能不能接这个单子的硬门槛。本文基于 RuoYi Office 真实源码讲清一套系统是怎么做到一套代码、多库兼容的以及国产化改造中真实存在的坑和回归建议——不吹不黑。▲ 信创多库全景一套代码 → MyBatis-Plus 运行时识别方言 自研 DbTypeEnum 主键策略自动适配 各库独立 DDL 脚本覆盖达梦/人大金仓/OpenGauss 等国产库引言信创改造到底卡在哪国产化改造的难点不在换驱动而在方言、主键、关键字处处不同。几个典型痛点痛点一主键策略不一样。MySQL 自增Oracle/金仓要序列达梦又是 IDENTITY——主键生成方式一换库就崩。痛点二SQL 方言不通用。FIND_IN_SET、LIMIT、分页、DUAL表在不同国产库写法不同。痛点三没有现成 DDL 脚本。MySQL 的建表语句直接拿到达梦上跑类型和语法对不上。痛点四评估到底支持哪些库。宣传说支持国产数据库但真实适配到什么程度需要心里有数。现状后果主键写死自增换序列库直接报错SQL 方言混用find_in_set 在 PG 系报错无国产库 DDL建表失败适配程度不明投标/交付踩坑方案一句话MyBatis-Plus 运行时识别方言 自研 DbTypeEnum 增强 主键策略自动切换 各库独立 DDL 脚本把换库成本降到最低。一、实测支持哪些库先把家底说清楚先给一个诚实的支持分级方便选型评估。一等支持指工程内有驱动、DDL 脚本、框架枚举、转换工具链级别数据库说明一等脚本驱动枚举工具链MySQL、Oracle、PostgreSQL、SQL Server、达梦 DM8、人大金仓 KingbaseES、OpenGauss信创主力库均在列二等MySQL 协议兼容TiDB、MariaDB、OceanBase走 MySQL 驱动无专属脚本未适配IBM DB2仓库自述暂未适配国产库驱动坐标按需引入optional数据库驱动坐标版本达梦 DM8com.dameng:DmJdbcDriver188.1.3.140人大金仓cn.com.kingbase:kingbase89.0.1.jre7OpenGaussorg.opengauss:opengauss-jdbc7.0.0-RC3-og诚实说明日常开发默认仍是 MySQL国产库是可切换的一等公民但生产交付前建议做模块级回归原因见第四节。二、方言增强自研 DbTypeEnum 抹平差异MyBatis-Plus 能运行时从 JDBC 连接自动识别方言框架再用自研DbTypeEnum对FIND_IN_SET等做逐库映射。这是一套代码多库的核心// DbTypeEnum为每种库定义 find_in_set 的等价 SQL 模板MY_SQL(DbType.MYSQL,MySQL,FIND_IN_SET(#{value}, #{column}) 0),POSTGRE_SQL(DbType.POSTGRE_SQL,PostgreSQL,POSITION(#{value} IN #{column}) 0),DM(DbType.DM,DM DBMS,FIND_IN_SET(#{value}, #{column}) 0),// 达梦MySQL 风格KINGBASE_ES(DbType.KINGBASE_ES,KingbaseES,POSITION(#{value} IN #{column}) 0);// 金仓PG 风格// 运行时按当前连接的产品名匹配publicstaticDbTypeEnumfind(StringdatabaseProductName){returnArrays.stream(values()).filter(e-e.getProductName().equals(databaseProductName)).findFirst().orElse(null);}设计要点达梦走 MySQL 风格FIND_IN_SET人大金仓走 PostgreSQL 风格POSITION——按各库的方言血缘归类。OpenGauss 不单独枚举它的DatabaseProductName与 PostgreSQL 相同运行时自动走 PG 分支。分页插件PaginationInnerInterceptor不手动 setDbType依赖 MyBatis-Plus 从连接自动识别天然支持 DM/金仓等 MP 已知方言。三、主键策略换库自动切 AUTO / 序列国产库主键差异最大框架用IdTypeEnvironmentPostProcessor在启动时按库类型自动选主键策略。无需手改实体// IdTypeEnvironmentPostProcessor启动时根据数据库类型自动设置 id-typeswitch(dbType){caseORACLE:casePOSTGRE_SQL:caseKINGBASE_ES:caseDB2:caseH2:setIdType(environment,IdType.INPUT);// 依赖序列 KeySequencebreak;caseMY_SQL:caseDM:default:setIdType(environment,IdType.AUTO);// MySQL 自增 / 达梦 IDENTITYbreak;}对需要序列的库框架按库注册对应的IKeyGeneratorDbTypeKeyGeneratorPostgreSQLPostgreKeyGeneratorOracleOracleKeyGenerator人大金仓 KingbaseESKingbaseKeyGenerator达梦 DMINPUT 模式时DmKeyGenerator实体只需声明序列名跨库通用// DO 上声明序列MySQL/达梦 走 AUTO 时该注解不生效PG/金仓走 INPUT 时启用KeySequence(system_user_seq)// Oracle、PostgreSQL、Kingbase、DB2、H2 需要TableName(system_users)publicclassAdminUserDOextendsTenantBaseDO{...}连 Quartz 定时任务的 JobStore 也按库切换委托PostgreSQL →PostgreSQLDelegateOracle →OracleDelegate达梦/金仓 → 标准StdJDBCDelegate。▲ 基础设施·数据源配置可管理多数据源、在线测试连接切换国产库时配置 JDBC URL 即可框架自动识别方言与主键策略四、切库实操到底要改什么换数据库只需三步配置 导脚本框架自动处理主键和方言。以切到达梦为例# application-dev.yaml改 master 数据源 URL驱动由 URL 推断spring:datasource:dynamic:primary:masterdruid:validation-query:SELECT 1 FROM DUAL# Oracle/达梦/金仓/PG 通用datasource:master:url:jdbc:dm://127.0.0.1:5236?schemaRUOYI_VUE_PRO# 达梦username:SYSDBApassword:SYSDBA001mybatis-plus:global-config:db-config:id-type:NONE# 保持 NONE由 PostProcessor 自动选 AUTO/INPUT配套动作步骤动作1引入对应库 JDBC 驱动依赖达梦DmJdbcDriver182导入对应库 DDLsql/dm/ruoyi-vue-pro-dm8.sql金仓sql/kingbase/OpenGausssql/opengauss/3改master数据源 URL/账号id-type保持 NONE4如需 MySQL→其他库转换可用sql/tools/convertor.py dm8▲ 基础设施·代码生成从数据库读取表结构生成代码多库环境下通过 JDBC Metadata 适配不同国产库的表/字段读取诚实的缺口提示信创改造务必心里有数部分业务 Mapper商城促销、CRM、IoT 等硬编码了FIND_IN_SET未统一走方言映射切到 PostgreSQL/金仓可能需要逐个改写代码生成器的菜单 SQL 模板未覆盖 OpenGauss 独立分支仓库无国产库集成测试用例。所以正确的态度是框架层一等支持 业务层模块回归。这正是真实信创项目该有的预期而不是换个 URL 就万事大吉。五、技术亮点总结设计要点实现方式价值方言识别MyBatis-Plus 运行时 DbTypeEnum一套代码多库主键自适配IdTypeEnvironmentPostProcessor换库不改实体序列生成按库注册 KeyGeneratorPG/金仓序列无感独立 DDLsql/dm、sql/kingbase、sql/opengauss建表开箱即用转换工具convertor.py 多目标MySQL→国产库一键转多数据源dynamic-datasource Druid异构库共存六、快速体验在线演示http://ruoyioffice.com/web/账号admin/admin123操作路径基础设施 → 数据源配置源码sql/目录下各库 DDL 脚本推荐体验流程查看数据源配置 → 看sql/dm、sql/kingbase脚本 → 试用 convertor.py 转换仓库地址后端GitHub · GitCode · Gitee前端GitCode延伸阅读多数据源与读写分离实战 · SpringBoot 多租户 SaaS 架构。常见问题FAQRuoYi Office 支持达梦、人大金仓吗支持且是一等支持有独立 DDL 脚本sql/dm、sql/kingbase、JDBC 驱动依赖、DbTypeEnum方言增强、主键策略自动适配达梦 AUTO/金仓序列、Quartz 委托切换。OpenGauss 同样有脚本与适配运行时识别为 PostgreSQL。从 MySQL 切到国产库要改代码吗主体不用。改spring.datasource.dynamic.master的 URL/账号、引入对应驱动、导入对应库 DDL、id-type保持 NONE 即可框架自动处理主键与方言。但需注意部分业务 Mapper 存在FIND_IN_SET硬编码切 PostgreSQL 系含金仓可能要逐个改写建议做模块回归。主键在不同数据库怎么处理启动时IdTypeEnvironmentPostProcessor按库自动选策略MySQL/达梦走 AUTO自增/IDENTITYOracle/PostgreSQL/金仓走 INPUT 序列配合KeySequence和对应 KeyGenerator。有没有 MySQL 转国产库的工具有。sql/tools/convertor.py支持把 MySQL DDL 转成 postgres/oracle/sqlserver/dm8/kingbase/opengauss 等目标库脚本。信创改造能换个 URL 就上线吗不能盲目乐观。框架层对国产库是一等支持但真实交付前建议做模块级回归重点关注FIND_IN_SET、分页、代码生成等这才是务实的信创落地态度。想要体验 RuoYi Office 的强大功能在线演示http://ruoyioffice.com/web/账号 admin / admin123源码仓库GitHub | GitCode | Gitee技术咨询添加微信17156169080备注「RuoYi Office」⭐如果觉得不错请给个 Star 支持一下