保姆级教程：用Druid连接池+Dm7JdbcDriver18搞定RuoYi与达梦数据库的整合

深度整合RuoYi与达梦数据库：Druid连接池配置全指南

在国产化技术替代浪潮中，达梦数据库作为国产数据库的代表之一，正逐渐进入企业级应用场景。而RuoYi作为国内广泛使用的快速开发框架，其与达梦数据库的适配成为许多开发团队面临的实际需求。本文将聚焦于Druid连接池与Dm7JdbcDriver18驱动的配置细节，提供一份从零开始的完整解决方案。

1. 环境准备与依赖配置

在开始配置前，我们需要确保开发环境已做好充分准备。与常见的MySQL配置不同，达梦数据库的JDBC驱动需要特别注意版本兼容性。

首先，在Maven项目中添加达梦数据库驱动依赖。虽然达梦官方未直接提供Maven中央仓库的依赖，但我们可以使用以下配置：

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

注意：版本号中的"7"代表达梦数据库主版本号，"18"表示支持的JDK版本。务必根据实际使用的达梦数据库版本和JDK版本选择合适的驱动。

同时，确保项目中已包含Druid连接池的依赖：

<dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> <version>1.2.8</version> </dependency>

环境检查清单：

• JDK版本：1.8或以上
• Spring Boot版本：2.x
• 达梦数据库服务已启动并可连接
• 网络连通性：确保应用服务器可以访问达梦数据库服务端口

2. 数据源详细配置解析

数据源配置是整个整合过程的核心环节。与MySQL配置相比，达梦数据库的连接参数有显著差异。以下是完整的application.yml配置示例：

spring: datasource: type: com.alibaba.druid.pool.DruidDataSource driver-class-name: dm.jdbc.driver.DmDriver url: jdbc:dm://192.168.1.100:5236/DAMENG?schema=SYSDBA username: SYSDBA password: Dameng123 druid: initial-size: 5 min-idle: 5 max-active: 20 max-wait: 60000 time-between-eviction-runs-millis: 60000 min-evictable-idle-time-millis: 300000 validation-query: SELECT 1 FROM DUAL test-while-idle: true test-on-borrow: false test-on-return: false

关键参数说明：

常见连接问题排查：

1. 连接超时：检查网络连通性，确认防火墙未阻止5236端口
2. 认证失败：确认用户名密码正确，注意达梦默认密码策略
3. 驱动类未找到：检查依赖是否正确引入，版本是否匹配
4. URL格式错误：确认实例名和schema配置正确

3. 分页插件与方言配置

RuoYi框架中常用的PageHelper分页插件需要针对达梦数据库进行特殊配置。由于达梦数据库语法更接近Oracle，我们需要相应调整方言设置：

pagehelper: helper-dialect: oracle reasonable: true support-methods-arguments: true params: count=countSql

提示：虽然达梦数据库语法与Oracle相似，但仍存在一些差异。复杂分页查询可能需要手动调整SQL。

对于MyBatis中的分页查询，达梦数据库支持两种分页方式：

1. ROWNUM方式（Oracle风格）：

SELECT * FROM ( SELECT A.*, ROWNUM RN FROM ( SELECT * FROM sys_user ORDER BY user_id ) A WHERE ROWNUM <= #{end} ) WHERE RN >= #{start}

2. LIMIT-OFFSET方式（MySQL风格，达梦7.6+支持）：

SELECT * FROM sys_user ORDER BY user_id LIMIT #{size} OFFSET #{offset}

实际项目中，建议统一使用PageHelper进行分页，避免直接编写分页SQL，以提高代码的可移植性。

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

达梦数据库与MySQL在SQL语法上存在诸多差异，这是整合过程中需要特别注意的部分。以下是常见差异及解决方案：

4.1 替换函数适配

REPLACE INTO → MERGE INTO

MySQL的REPLACE INTO在达梦中需要使用MERGE INTO替代：

<!-- 原MySQL语法 --> <insert id="saveOnline"> REPLACE INTO sys_user_online(sessionId, login_name) VALUES (#{sessionId}, #{loginName}) </insert> <!-- 达梦适配语法 --> <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 login_name = d.login_name WHEN NOT MATCHED THEN INSERT (sessionId, login_name) VALUES(d.sessionId, d.login_name) </insert>

FIND_IN_SET → INSTR

MySQL的FIND_IN_SET函数在达梦中可用INSTR替代：

-- 原MySQL语法 SELECT * FROM sys_dept WHERE find_in_set(#{deptId}, ancestors) -- 达梦适配语法 SELECT * FROM sys_dept WHERE instr(','||ancestors||',', ','||#{deptId}||',') > 0

4.2 数据类型差异处理

达梦数据库与MySQL在数据类型上也存在差异，需要特别注意：

对于CHAR类型，达梦数据库中最小长度为4字节，这可能导致数据读取时出现空格填充问题。解决方案：

1. 修改表结构使用VARCHAR替代CHAR
2. 在Java实体类中使用@Trim注解处理字符串
3. 在查询中使用TRIM()函数处理结果

// 实体类中处理CHAR字段 @Column(name = "status") @Trim private String status;

5. 性能优化与监控配置

完成基本整合后，我们需要对Druid连接池进行优化配置，并设置监控功能以确保系统稳定运行。

5.1 连接池优化参数

spring: datasource: druid: # 连接池大小配置 initial-size: 5 min-idle: 5 max-active: 20 # 性能相关配置 max-wait: 60000 time-between-eviction-runs-millis: 60000 min-evictable-idle-time-millis: 300000 # 监控统计配置 stat-view-servlet: enabled: true url-pattern: /druid/* login-username: admin login-password: admin web-stat-filter: enabled: true url-pattern: /* exclusions: "*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*"

5.2 SQL性能监控

达梦数据库提供了丰富的性能监控工具，可以与Druid监控结合使用：

1. 开启Druid的SQL监控：

spring: datasource: druid: filters: stat,wall,log4j filter: stat: log-slow-sql: true slow-sql-millis: 1000 merge-sql: true

2. 使用达梦性能视图：

-- 查看当前会话执行的SQL SELECT * FROM V$SQL WHERE SESS_ID = SYS_CONTEXT('SESSIONID'); -- 查看慢SQL SELECT * FROM V$SQL_AREA WHERE ELAPSED_TIME > 1000000;

3. 定期分析执行计划：

EXPLAIN PLAN FOR SELECT * FROM sys_user WHERE user_id = 1; SELECT * FROM TABLE(DBMS_XPLAN.DISPLAY());

6. 常见问题解决方案

在实际整合过程中，开发团队可能会遇到以下典型问题：

问题1：连接池初始化失败

现象：应用启动时报"Failed to initialize Druid datasource"

解决方案：

1. 检查driver-class-name是否正确
2. 确认URL格式符合达梦规范
3. 验证网络连通性和数据库服务状态
4. 调整连接超时参数max-wait

问题2：SQL语法不兼容

现象：执行SQL时报语法错误

解决方案：

1. 使用达梦提供的SQL转换工具
2. 修改MyBatis映射文件中的SQL语句
3. 在应用层重写业务逻辑

问题3：字符集问题

现象：中文字符显示为乱码

解决方案：

1. 确保数据库使用UTF-8或GB18030字符集
2. 在JDBC URL中添加字符集参数：

url: jdbc:dm://localhost:5236/DAMENG?charset=UTF-8

问题4：事务处理差异

现象：事务行为与MySQL不一致

解决方案：

1. 明确设置事务隔离级别
2. 检查达梦数据库的事务配置
3. 在Spring中显式配置事务管理器

@Bean public PlatformTransactionManager transactionManager(DataSource dataSource) { return new DataSourceTransactionManager(dataSource); }

7. 高级配置与最佳实践

对于企业级应用，我们还需要考虑一些高级配置和最佳实践：

7.1 多数据源配置

当系统需要同时访问达梦和其他数据库时，可配置多数据源：

@Configuration public class DataSourceConfig { @Primary @Bean(name = "dmDataSource") @ConfigurationProperties(prefix = "spring.datasource.druid.dm") public DataSource dmDataSource() { return DruidDataSourceBuilder.create().build(); } @Bean(name = "otherDataSource") @ConfigurationProperties(prefix = "spring.datasource.druid.other") public DataSource otherDataSource() { return DruidDataSourceBuilder.create().build(); } }

对应YAML配置：

spring: datasource: druid: dm: url: jdbc:dm://localhost:5236/DAMENG username: SYSDBA password: Dameng123 other: url: jdbc:mysql://localhost:3306/other_db username: root password: mysql123

7.2 连接池自适应调整

根据实际负载动态调整连接池参数：

spring: datasource: druid: # 根据CPU核心数自动计算 max-active: ${T(java.lang.Runtime).getRuntime().availableProcessors() * 2 + 1} # 根据内存大小自动计算 max-wait: ${T(java.lang.Runtime).getRuntime().maxMemory() / 1024 / 1024 > 2048 ? 60000 : 30000}

7.3 达梦特有功能利用

达梦数据库提供了一些特有功能，可以提升应用性能：

1. 并行查询：

SELECT /*+ PARALLEL(4) */ * FROM large_table WHERE condition;

2. 内存表：

CREATE GLOBAL TEMPORARY TABLE temp_session_data ( id NUMBER, data VARCHAR(4000) ) ON COMMIT PRESERVE ROWS;

3. 分区表：

CREATE TABLE sales ( sale_id NUMBER, sale_date DATE, amount NUMBER ) PARTITION BY RANGE (sale_date) ( PARTITION p2020 VALUES LESS THAN (TO_DATE('2021-01-01', 'YYYY-MM-DD')), PARTITION p2021 VALUES LESS THAN (TO_DATE('2022-01-01', 'YYYY-MM-DD')) );