RuoYi框架国产化迁移实战：SpringBoot项目适配达梦数据库的关键步骤与避坑指南-编程阁

1. 从MySQL到达梦：国产化迁移的技术选型思考

最近接手了一个RuoYi框架的国产化改造项目，需要把原本跑在MySQL上的SpringBoot系统迁移到达梦数据库。说实话，第一次接触达梦时心里有点打鼓——毕竟国产数据库的社区资料确实不如MySQL丰富。但实际做下来发现，只要掌握几个关键点，迁移过程并没有想象中那么困难。

达梦作为国产数据库的佼佼者，在政务、金融等领域应用广泛。它与Oracle语法高度兼容，这对熟悉Oracle的开发者是个好消息。不过从MySQL迁移过来时，还是会遇到一些语法差异和兼容性问题。下面我就把实战中积累的经验，特别是那些容易踩坑的细节，完整分享给大家。

2. 基础环境配置：驱动与连接池

2.1 JDBC驱动的正确打开方式

最开始我按照网上的老方法，准备从达梦安装目录拷贝jdbc驱动jar包到项目里。但偶然在Maven中央仓库搜索时，惊喜地发现了官方维护的依赖：

<dependency> <groupId>com.dameng</groupId> <artifactId>Dm7JdbcDriver18</artifactId> <version>7.6.0.165</version> </dependency>

这里有个命名规则要注意：Dm7JdbcDriver18中的7代表达梦数据库主版本号，18对应JDK版本。如果你们用的是JDK1.8，就选带18后缀的驱动版本。

2.2 数据源配置的细节调整

在application.yml中配置Druid连接池时，有几个关键参数需要修改：

spring: datasource: type: com.alibaba.druid.pool.DruidDataSource driverClassName: dm.jdbc.driver.DmDriver druid: master: url: jdbc:dm://127.0.0.1:5236 username: SYSDBA password: Dameng123

特别提醒：达梦默认的系统管理员账号是SYSDBA，而不是MySQL常见的root。端口号5236是达梦的默认服务端口，相当于MySQL的3306。

3. 分页插件的适配技巧

3.1 PageHelper方言设置

RuoYi框架大量使用了PageHelper分页插件。由于达梦的SQL语法更接近Oracle，需要调整helperDialect参数：

pagehelper: helperDialect: oracle supportMethodsArguments: true params: count=countSql

这里有个坑我踩过：如果保持原来的mysql方言，生成的LIMIT语句在达梦里会直接报语法错误。改成oracle后，PageHelper会自动生成适合达梦的ROWNUM分页语句。

3.2 分页查询性能优化

达梦处理大数据量分页时，建议使用下面这种写法：

SELECT * FROM ( SELECT tmp.*, ROWNUM rn FROM ( -- 你的原始查询语句 SELECT id, name FROM sys_user ) tmp WHERE ROWNUM <= #{end} ) WHERE rn > #{start}

这种嵌套查询的方式在达梦上性能更好，比简单的WHERE ROWNUM BETWEEN #{start} AND #{end}效率高得多。

4. SQL语法差异与适配方案

4.1 替换replace into的优雅方案

记录在线用户功能用到了MySQL特有的replace into，达梦不支持这个语法。我最终用merge into实现了相同功能：

<insert id="saveOnline"> merge into sys_user_online using ( select #{sessionId} sessionId, #{loginName} login_name from dual ) d on sys_user_online.sessionId = d.sessionId when matched then update set sys_user_online.login_name = d.login_name when not matched then insert (sessionId, login_name) values(d.sessionId, d.login_name) </insert>

merge into语法虽然复杂些，但功能更强大。它先尝试匹配记录，存在则更新，不存在则插入，完美替代replace into。

4.2 处理find_in_set的替代方案

部门管理的祖先节点查询用到了find_in_set，达梦里可以用instr函数替代：

-- 原MySQL写法 find_in_set(#{deptId}, ancestors) -- 达梦适配方案 instr(','||ancestors||',', ','||#{deptId}||',') > 0

这个技巧是在字符串前后都加上逗号，然后用instr查找,deptId,的模式，避免误匹配。

5. 数据类型与隐式转换问题

5.1 CHAR类型的坑

达梦处理CHAR类型时有个特别之处：它会自动用空格填充到定义的长度。比如定义CHAR(4)存数字1，实际存储的是"1 "。这会导致两个问题：

前端显示多余空格
条件查询可能不匹配

解决方案有两种：

// 方案1：代码中trim处理 user.setCharField(charField.trim()); // 方案2：改用VARCHAR类型 ALTER TABLE sys_config MODIFY config_value VARCHAR(100);

5.2 日期时间处理差异

达梦的日期函数和MySQL有些不同：

NOW()→CURRENT_TIMESTAMP
DATE_FORMAT→TO_CHAR
STR_TO_DATE→TO_DATE

例如查询当天日志：

-- MySQL WHERE DATE_FORMAT(create_time, '%Y-%m-%d') = CURDATE() -- 达梦 WHERE TO_CHAR(create_time, 'YYYY-MM-DD') = TO_CHAR(CURRENT_DATE, 'YYYY-MM-DD')

6. 代码生成模块的特殊处理

RuoYi的代码生成功能需要读取数据库元数据，这部分需要额外适配：

修改GenTableMapper.xml中的信息查询SQL
调整数据类型映射关系
处理达梦特有的系统表命名规则

比如查询表结构的SQL要改成：

SELECT t.TABLE_NAME, c.COMMENTS AS table_comment FROM ALL_TABLES t LEFT JOIN ALL_TAB_COMMENTS c ON t.TABLE_NAME = c.TABLE_NAME WHERE t.OWNER = 'SYSDBA'

7. 调试与验证技巧

迁移完成后，我总结了一套验证方案：

基础功能检查清单：
- 用户登录和权限验证
- 分页查询结果准确性
- 事务回滚测试
- 批量操作性能

SQL兼容性检查：

// 开启SQL日志 logging: level: org.springframework.jdbc: DEBUG

性能对比测试：
- 使用JMeter对比关键接口响应时间
- 监控连接池使用情况
- 检查慢查询日志

整个迁移过程最耗时的其实是找出所有需要适配的SQL语句。建议大家在正式迁移前，先用达梦的SQL分析工具对原有SQL做全面检查，能提前发现大部分语法兼容问题。

RuoYi框架国产化迁移实战：SpringBoot项目适配达梦数据库的关键步骤与避坑指南