1. 项目缘起当Druid遇上达梦8在Java后端开发里数据库连接池几乎是每个项目的标配。它负责管理数据库连接的创建、分配、销毁直接关系到应用的并发性能和稳定性。阿里开源的Druid凭借其强大的监控、防SQL注入、以及出色的性能在国内开发者群体中有着极高的占有率。而达梦数据库DM8作为国产数据库的重要代表在信创、金融、政务等领域正得到越来越广泛的应用。那么一个很自然的问题就来了我们能否将这两者结合起来用我们熟悉的、功能强大的Druid来管理达梦8的数据库连接答案是肯定的但这个过程并非简单的“拿来即用”。Druid的官方文档和社区讨论大多围绕MySQL、Oracle、PostgreSQL等主流数据库展开关于达梦的配置细节散落在各个角落甚至有些“坑”需要亲自踩过才知道。我最近在一个需要适配达梦8的项目中就遇到了这个需求。从最初的“这应该很简单”到中间遇到驱动加载、配置项不生效、监控页面打不开等一系列问题再到最终稳定运行整个过程积累了不少实战经验。这篇文章我就来详细拆解如何正确、高效地在Spring Boot项目中配置Druid连接池来连接达梦8数据库并分享那些官方文档不会告诉你的细节和避坑指南。2. 环境准备与核心依赖引入在开始配置之前我们必须把“地基”打好。这里的环境准备不仅仅是引入JAR包那么简单更需要理解每个依赖的作用以及版本兼容性可能带来的影响。2.1 达梦8 JDBC驱动获取与注意事项达梦数据库的JDBC驱动并不像MySQL驱动那样可以直接从Maven中央仓库获取。这是第一个需要注意的点。官方获取途径你需要从达梦数据库的官方网站下载安装包或驱动包。通常在安装达梦数据库后在其安装目录的/drivers/jdbc路径下可以找到JAR文件例如DmJdbcDriver18.jar。请务必确认驱动版本与你的达梦数据库服务器版本相匹配使用不匹配的驱动可能会导致连接失败或出现不可预知的错误。手动引入项目由于不是中央仓库依赖我们需要手动将下载的DmJdbcDriver18.jar文件放入项目的lib目录如果没有可以新建然后在构建工具中引入。如果你使用Maven可以在项目根目录创建lib文件夹存放驱动JAR然后在pom.xml中通过system作用域引入dependency groupIdcom.dameng/groupId artifactIdDmJdbcDriver18/artifactId version8.1.1.49/version !-- 版本号请根据实际文件修改 -- scopesystem/scope systemPath${project.basedir}/lib/DmJdbcDriver18.jar/systemPath /dependency注意system作用域的依赖在打包时尤其是打可执行JAR包不会被自动包含进去。这对于Spring Boot应用是个大问题。更推荐的做法是使用maven-install-plugin将驱动安装到本地仓库或者使用公司内部的Nexus私服进行管理。安装到本地仓库的命令示例如下mvn install:install-file -Dfilelib/DmJdbcDriver18.jar -DgroupIdcom.dameng -DartifactIdDmJdbcDriver18 -Dversion8.1.1.49 -Dpackagingjar安装成功后就可以将上述依赖的scope改为compile或直接删除scope和systemPath配置。2.2 Spring Boot与Druid依赖配置接下来是引入Spring Boot和Druid的相关依赖。我们假设项目基于Spring Boot 2.x。parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version !-- 建议使用一个稳定的长期支持版本 -- relativePath/ /parent dependencies !-- Spring Boot Web Starter (根据你的项目类型选择) -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- Spring Boot JDBC Starter 它包含了spring-jdbc和事务管理等 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-jdbc/artifactId /dependency !-- Druid官方提供的Spring Boot Starter简化配置 -- dependency groupIdcom.alibaba/groupId artifactIddruid-spring-boot-starter/artifactId version1.2.20/version !-- 请使用最新稳定版 -- /dependency !-- 达梦驱动假设已安装到本地仓库 -- dependency groupIdcom.dameng/groupId artifactIdDmJdbcDriver18/artifactId version8.1.1.49/version /dependency !-- 其他项目依赖... -- /dependencies这里的关键是druid-spring-boot-starter它为我们提供了与Spring Boot配置属性文件application.yml或application.properties无缝集成的能力无需编写大量的Bean配置代码。3. 核心配置详解从连接URL到监控面板依赖就绪后核心工作就落在了配置文件上。我将分模块详细解释每个配置项的含义、针对达梦8的特殊设置以及如何避免常见陷阱。3.1 基础数据源与连接参数配置在application.yml中我们进行如下配置application.properties的写法类似按需转换spring: datasource: # 1. 指定数据源类型为 DruidDataSource type: com.alibaba.druid.pool.DruidDataSource # 2. 驱动类名这是达梦8的驱动 driver-class-name: dm.jdbc.driver.DmDriver # 3. 连接URL这是配置的关键 url: jdbc:dm://192.168.1.100:5236/DAMENG?schemaSYSDBAzeroDateTimeBehaviorconvertToNulluseUnicodetruecharacterEncodingutf-8 # 4. 用户名和密码 username: SYSDBA password: SYSDBA # 以下是Druid连接池的专属配置以 druid 为前缀 druid: # 5. 初始化连接数 initial-size: 5 # 6. 最小空闲连接数 min-idle: 5 # 7. 最大活跃连接数 max-active: 20 # 8. 获取连接时最大等待时间毫秒 max-wait: 60000 # 9. 配置间隔多久检测一次需要关闭的空闲连接毫秒 time-between-eviction-runs-millis: 60000 # 10. 连接在池中最小生存的时间毫秒 min-evictable-idle-time-millis: 300000 # 11. 验证连接是否有效的SQL validation-query: SELECT Hello FROM DUAL # 12. 申请连接时是否执行validationQuery检测 test-on-borrow: false # 13. 归还连接时是否执行validationQuery检测 test-on-return: false # 14. 空闲时是否执行validationQuery检测 test-while-idle: true针对达梦8的关键配置解析driver-class-name: 必须准确填写dm.jdbc.driver.DmDriver。有时网上老资料会写成dm.jdbc.driver.DmdbDriver这在DM8中已不适用务必确认。url: 这是最容易出错的地方。jdbc:dm://是达梦的JDBC协议头。192.168.1.100:5236是数据库服务器的IP和端口达梦默认端口是5236。DAMENG是数据库名在达梦安装时创建。schemaSYSDBA这个参数至关重要达梦数据库的模式Schema概念与用户强关联。SYSDBA是默认的超级管理员用户也是其默认模式。如果不指定连接后可能找不到属于该用户的表。这是与MySQL配置的一个显著区别。后面的zeroDateTimeBehaviorconvertToNulluseUnicodetruecharacterEncodingutf-8是我从MySQL配置习惯迁移过来的对于达梦characterEncoding通常是有效的但其他参数达梦驱动可能不支持或忽略不过写上一般也无害。更标准的达梦连接参数可以参考官方文档例如compatibleModemysql兼容模式等。validation-query: 连接有效性检测的SQL。对于达梦SELECT Hello FROM DUAL或SELECT 1都是可用的。DUAL是达梦中的虚拟表类似于Oracle。务必确保这个SQL语句简单且能在你的数据库上执行成功这是连接池健康检测的基础。3.2 监控配置与防火墙规则Druid的一大亮点就是内置了强大的监控功能。要启用监控统计和Web界面需要添加以下配置spring: datasource: druid: # 监控统计相关配置 # 15. 开启监控统计 web-stat-filter: enabled: true url-pattern: /* exclusions: *.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/* # 16. 开启StatViewServlet监控页面 stat-view-servlet: enabled: true url-pattern: /druid/* # 登录监控页面的用户名密码 login-username: admin login-password: admin123 # 是否允许重置监控数据 reset-enable: false # 允许访问的IP为空表示允许所有生产环境务必设置 allow: 127.0.0.1 # 拒绝访问的IP deny: # 17. 配置监控统计的过滤器 filter: stat: enabled: true # 合并多个相同的SQL merge-sql: true # 记录慢SQL的阈值毫秒 slow-sql-millis: 2000 log-slow-sql: true wall: enabled: true # 开启SQL防火墙防注入 config: enabled: true # 支持个性化的过滤器配置配置要点与避坑url-pattern:web-stat-filter的url-pattern通常设置为/*以统计所有Web请求。而stat-view-servlet的url-pattern设置为/druid/*这意味着监控页面的访问地址是http://你的应用地址:端口/druid/index.html。登录安全login-username和login-password在生产环境下必须修改并且要设置强密码避免监控信息泄露。访问控制allow和deny用于IP白名单和黑名单控制。在生产环境中强烈建议将allow设置为运维或管理员机器的IP禁止公网直接访问。reset-enable建议设为false防止误操作清空宝贵的监控数据。慢SQL监控slow-sql-millis定义了慢查询的阈值结合log-slow-sql: true可以在Druid监控页面的“SQL监控”中直接看到慢SQL语句和执行时间是性能调优的利器。3.3 达梦8特有的配置调优建议不同的数据库对连接池的行为可能有细微差别针对达梦8我推荐以下调优配置spring: datasource: druid: # 连接属性以键值对形式传递给JDBC驱动 connection-properties: druid.stat.mergeSqltrue;druid.stat.slowSqlMillis2000;config.decryptfalse # 物理连接创建时的初始化SQL可用于设置会话级变量 connection-init-sqls: SET SCHEMA SYSDBA # 是否缓存PreparedStatementPSCache。达梦对游标支持较好可以开启以提升性能。 pool-prepared-statements: true # PSCache的大小 max-pool-prepared-statement-per-connection-size: 20connection-init-sqls: 这个配置非常有用。它会在每个物理连接被创建后、放入连接池之前执行。这里我们设置为SET SCHEMA SYSDBA可以确保从连接池取出的连接默认就在SYSDBA模式下避免在代码中每次操作都要指定模式名。这对于多租户或需要切换Schema的场景是必备配置。pool-prepared-statements: 开启预编译语句缓存。对于需要反复执行相同SQL模板参数不同的场景如批量操作能显著提升性能。达梦数据库支持此特性建议开启。max-pool-prepared-statement-per-connection-size: 每个连接上缓存的预编译语句数量。需要根据应用SQL的多样性进行调整太小可能缓存命中率低太大则占用内存。4. 启动验证与深度问题排查配置完成后启动Spring Boot应用。如果控制台没有报出数据库连接相关的错误并且能看到类似DruidDataSource已初始化的日志那么基础连接就成功了。4.1 访问监控页面进行验证在浏览器中访问http://localhost:你的应用端口/druid/index.html输入配置的用户名和密码如admin/admin123。如果成功进入你会看到Druid强大的监控面板包括数据源可以看到连接池的活跃连接数、等待线程数等实时状态。SQL监控所有执行过的SQL及其执行时间、读取行数等统计信息慢SQL会高亮显示。SQL防火墙展示被防火墙拦截的SQL尝试。Web应用展示URI请求的监控数据。如果无法访问监控页面请按以下步骤排查检查配置是否生效首先确认stat-view-servlet.enabled是否为true且url-pattern配置正确。检查Spring Security等安全框架如果你的项目引入了Spring Security、Shiro等安全框架它们可能会拦截/druid/*路径。你需要在安全配置中为Druid的监控路径放行。例如在Spring Security配置中Override protected void configure(HttpSecurity http) throws Exception { http.authorizeRequests() .antMatchers(/druid/**).permitAll() // 放行Druid监控路径 .anyRequest().authenticated() .and().formLogin(); }检查过滤器顺序如果项目中有自定义的Filter可能会影响Druid的StatFilter。确保Druid的过滤器被正确注册。4.2 连接泄漏与活跃连接数异常排查在监控页面的“数据源”选项卡如果发现“活跃连接数”Active Count持续增长且不下降甚至接近max-active而“执行查询”的并发并不高这很可能发生了连接泄漏。连接泄漏的典型原因和排查方法未正确关闭连接或ResultSet、Statement这是最常见的原因。虽然我们使用Spring的JdbcTemplate或MyBatis等框架它们通常会帮我们管理连接但在某些手动获取连接的场景如复杂事务、多数据源必须确保在finally块中调用connection.close()实际上是将连接归还给连接池。排查检查代码中所有DataSourceUtils.getConnection()、dataSource.getConnection()的地方是否都有对应的释放操作。使用try-with-resources语法是很好的习惯。事务未及时提交或回滚一个长时间运行且未结束的事务会一直占用一个连接。排查检查业务逻辑中事务的边界是否合理。避免在事务中进行远程调用、文件IO等耗时操作。可以使用Transactional(timeout 秒数)设置事务超时。Druid配置不当validation-query设置错误或数据库网络不稳定导致连接池误判连接失效不断创建新连接。排查将test-on-borrow设为true可以更严格地检测但会牺牲一点性能。同时确保网络稳定并优化validation-query。利用Druid监控定位泄漏点在监控页面“连接池”详情里Druid有时会直接提示疑似泄漏的连接堆栈。开启Druid的“移除长时间不关闭连接”的日志。在配置中添加spring: datasource: druid: remove-abandoned: true # 是否移除泄露的连接 remove-abandoned-timeout: 300 # 泄露连接的超时时间秒 log-abandoned: true # 是否记录移除连接的日志当连接占用超过300秒未关闭Druid会强制回收并打印警告日志日志中会包含该连接被获取时的调用堆栈这是定位泄漏代码的黄金信息。4.3 达梦8与Druid兼容性深水区问题在一些特定场景下你可能会遇到更棘手的问题问题一监控页面的“SQL监控”中看不到任何SQL语句。原因Druid的SQL监控依赖于其内置的StatFilter。如果SQL执行没有经过这个过滤器就不会被统计。解决方案确保druid.filter.stat.enabledtrue。如果你使用了多个数据源需要为每个数据源单独配置DruidDataSourceBean并在Bean的setFilters属性中明确加入stat。对于druid-spring-boot-starter和单数据源通常会自动配置好。某些数据库操作比如通过Hibernate原生SQL查询或者一些非常底层的JDBC操作可能绕过了Spring的包装从而绕过了过滤器。这种情况需要检查代码路径。问题二连接池初始化失败报错“discard connection”或“communications link failure”。原因数据库服务器防火墙未开放5236端口达梦数据库服务未启动连接URL、用户名、密码错误或者达梦数据库的max_sessions最大会话数参数已满。排查使用数据库客户端工具如达梦的管理工具尝试连接验证网络和基础账号密码。检查达梦数据库的V$SESSIONS视图查看当前会话数。检查Druid的initial-size如果设置过大在数据库压力大时可能一次性创建连接失败。问题三执行一段时间后出现“连接已关闭”的错误。原因数据库服务端主动断开了空闲连接可能由于数据库的session_timeout或网络设备超时而Druid连接池并不知道仍然将失效的连接分配给应用。解决方案优化Druid的连接保活配置。spring: datasource: druid: test-while-idle: true # 必须为true time-between-eviction-runs-millis: 60000 # 检测间隔不宜过长如1分钟 min-evictable-idle-time-millis: 300000 # 最小空闲时间如5分钟 validation-query: SELECT 1 # 确保这个查询高效且正确这样配置后Druid会每隔60秒检测一次空闲时间超过5分钟的连接并用validation-query测试其有效性无效则丢弃并创建新的。5. 生产环境部署的进阶考量当应用准备上生产时关于Druid和达梦8的配置还需要从运维和安全的视角进行加固。5.1 配置加密与敏感信息保护在application.yml中明文存储数据库密码是极不安全的。Druid支持对密码进行加密。生成加密密码使用Druid自带的com.alibaba.druid.filter.config.ConfigTools类进行加密。java -cp druid-1.2.20.jar com.alibaba.druid.filter.config.ConfigTools 你的明文密码命令会输出公钥publicKey和加密后的密码password。修改配置文件spring: datasource: password: {加密后的密码字符串} druid: connection-properties: config.decrypttrue;config.decrypt.key{你的公钥字符串} filter: config: enabled: true # 必须启用config过滤器这样Druid在启动时会使用配置的公钥对加密的密码进行解密。5.2 多数据源与读写分离配置在微服务或复杂应用中可能需要连接多个达梦数据库实例或者配置读写分离。多数据源配置核心思路你需要创建多个DataSourceBean并分别指定它们的Druid配置。同时需要使用Primary注解指定一个主数据源。这里的关键是每个数据源的Druid监控过滤器需要独立配置。Configuration public class DataSourceConfig { Primary Bean(name masterDataSource) ConfigurationProperties(prefix spring.datasource.druid.master) public DataSource masterDataSource() { return DruidDataSourceBuilder.create().build(); } Bean(name slaveDataSource) ConfigurationProperties(prefix spring.datasource.druid.slave) public DataSource slaveDataSource() { return DruidDataSourceBuilder.create().build(); } // 如果需要可以在这里配置动态数据源路由如使用AbstractRoutingDataSource }对应的application.yml配置spring: datasource: type: com.alibaba.druid.pool.DruidDataSource druid: master: url: jdbc:dm://master-host:5236/DAMENG username: master_user password: master_pwd driver-class-name: dm.jdbc.driver.DmDriver initial-size: 5 # ... 其他master专属配置 filters: stat,wall,config # 为master数据源显式指定过滤器 slave: url: jdbc:dm://slave-host:5236/DAMENG username: slave_user password: slave_pwd driver-class-name: dm.jdbc.driver.DmDriver initial-size: 3 # ... 其他slave专属配置 filters: stat,wall,config # 为slave数据源显式指定过滤器 # 全局的web-stat-filter和stat-view-servlet通常只需一份它们基于Servlet上下文不绑定特定数据源 web-stat-filter: enabled: true url-pattern: /* stat-view-servlet: enabled: true url-pattern: /druid/*5.3 监控集成与告警Druid的监控数据可以通过JMX暴露出来方便与公司现有的监控系统如Prometheus Grafana, Zabbix集成。开启JMX在JVM启动参数中添加-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port你的端口 -Dcom.sun.management.jmxremote.sslfalse -Dcom.sun.management.jmxremote.authenticatefalse生产环境请启用认证和SSL。使用JMX Exporter对于Prometheus可以使用jmx_exporter来抓取Druid MBean的数据。你需要配置一个config.yaml文件定义要收集的MBean指标。关键监控指标activeCount: 活跃连接数。持续高位报警。waitThreadCount: 等待获取连接的线程数。大于0且持续增长说明连接池可能成为瓶颈。connectCount: 总连接创建次数。异常飙升可能意味着连接泄漏或数据库重启。errorCount: 错误次数。将这些指标可视化并设置合理的告警阈值例如活跃连接数超过max-active的80%就告警是保障生产系统稳定的重要一环。6. 性能调优实战从参数到SQL配置正确只是第一步要让“Druid 达梦8”的组合发挥最佳性能还需要进行精细化的调优。6.1 连接池参数调优公式与思路连接池参数没有银弹需要根据实际压力测试结果调整。以下是一个基于经验的调优思路max-active(最大连接数)这是最重要的参数。理论最大值受数据库服务器max_connections限制通常设置为该值的70%-80%为系统其他应用或管理会话留出空间。应用端估算一个粗略的估算公式是max-active Tn / (Tc * (1 - Tt))。其中Tn是应用平均每秒事务数Tc是每个事务平均耗时秒Tt是事务耗时中数据库操作所占比例。但这很难精确计算。压力测试法最可靠的方法。在模拟生产压力的测试中逐步增加并发用户数观察应用响应时间和数据库负载。当响应时间开始非线性增长或数据库CPU/连接数达到瓶颈时当时的活跃连接数就是max-active的参考值。初始值可以设置为20-50。min-idle(最小空闲连接)保持一定数量的“热”连接避免突发请求时频繁创建连接的开销。通常设置为max-active的10%-20%或根据应用低谷期的流量确定。不宜设置过大否则会浪费数据库资源。max-wait(获取连接超时时间)当连接池耗尽时应用线程等待获取连接的最长时间。超过则抛异常。根据业务容忍度设置一般设为3-10秒。设置过短会导致大量获取连接超时异常设置过长则线程堆积可能拖垮整个应用。time-between-eviction-runs-millis和min-evictable-idle-time-millis(连接逐出策略)time-between-eviction-runs-millis检测间隔。建议设置为min-evictable-idle-time-millis的1/3到1/2。例如空闲连接5分钟淘汰那么可以每1-2分钟检测一次。不宜过频增加开销也不宜过疏连接无效时间过长。min-evictable-idle-time-millis连接最小空闲时间。要略小于数据库服务器端会话超时时间。如果达梦数据库的session_timeout是10分钟这里可以设置为8-9分钟确保在数据库踢掉连接之前连接池自己先回收。6.2 利用Druid监控进行SQL层优化连接池调优解决的是“连接管理”的问题而数据库性能的瓶颈往往在SQL本身。Druid的“SQL监控”和“慢SQL日志”是定位问题SQL的绝佳工具。识别慢SQL在监控页面按照“执行时间”或“执行次数*平均时间”排序找出最耗资源的SQL。分析SQL模式关注是否出现大量相似SQL仅参数不同这可能是MyBatis等框架动态生成的SQL考虑是否可以使用sql标签复用或优化逻辑。结合达梦执行计划将Druid抓取到的慢SQL到达梦数据库中使用EXPLAIN命令查看其执行计划。重点关注全表扫描TABLE SCAN是否缺少必要的索引。索引选择不当达梦的优化器可能选择了不合适的索引。可以使用INDEX HINT进行强制索引测试。嵌套循环连接NESTED LOOP效率低下对于大数据集关联考虑是否适合使用哈希连接HASH JOIN或归并连接MERGE JOIN有时需要调整统计信息或使用优化器提示。关注结果集大小Druid会显示“读取行数”。如果一个查询返回了数万行但前端只显示10条那很可能需要优化SQL增加分页或过滤条件。6.3 达梦8特定性能配置联动除了连接池和SQL达梦数据库本身的配置也与性能息息相关需要与连接池配置联动考虑。会话参数可以通过Druid的connection-init-sqls为连接设置一些优化参数。例如connection-init-sqls: SET SCHEMA SYSDBA; SET OPTIMIZER_MODE1这里OPTIMIZER_MODE1是达梦的一种优化器模式。但要注意这些设置是会话级的对全局影响需要谨慎评估。最好在数据库管理员指导下进行。游标缓存达梦的CURSOR_CACHE_SIZE参数会影响游标缓存。如果应用使用了大量可滚动的结果集或存储过程返回游标适当调整此参数可能有益。但这属于数据库服务器端调优与应用连接池配置间接相关。经过以上从基础配置到生产调优的全流程梳理相信你已经能够驾驭“阿里Druid连接池配置达梦8”这个任务。记住所有配置的最佳值都源于对自身应用行为和数据库负载的持续观察与测试。开始时可以使用保守的默认值上线后结合Druid监控提供的数据进行小步快跑式的迭代优化最终让这套组合在你的生产环境中稳定高效地运行。 
长河君 · 2026/8/16 5:09:57 · 阅读 1.2k Spring Boot整合Druid连接达梦8：配置详解与生产环境调优指南
1. 项目缘起当Druid遇上达梦8在Java后端开发里数据库连接池几乎是每个项目的标配。它负责管理数据库连接的创建、分配、销毁直接关系到应用的并发性能和稳定性。阿里开源的Druid凭借其强大的监控、防SQL注入、以及出色的性能在国内开发者群体中有着极高的占有率。而达梦数据库DM8作为国产数据库的重要代表在信创、金融、政务等领域正得到越来越广泛的应用。那么一个很自然的问题就来了我们能否将这两者结合起来用我们熟悉的、功能强大的Druid来管理达梦8的数据库连接答案是肯定的但这个过程并非简单的“拿来即用”。Druid的官方文档和社区讨论大多围绕MySQL、Oracle、PostgreSQL等主流数据库展开关于达梦的配置细节散落在各个角落甚至有些“坑”需要亲自踩过才知道。我最近在一个需要适配达梦8的项目中就遇到了这个需求。从最初的“这应该很简单”到中间遇到驱动加载、配置项不生效、监控页面打不开等一系列问题再到最终稳定运行整个过程积累了不少实战经验。这篇文章我就来详细拆解如何正确、高效地在Spring Boot项目中配置Druid连接池来连接达梦8数据库并分享那些官方文档不会告诉你的细节和避坑指南。2. 环境准备与核心依赖引入在开始配置之前我们必须把“地基”打好。这里的环境准备不仅仅是引入JAR包那么简单更需要理解每个依赖的作用以及版本兼容性可能带来的影响。2.1 达梦8 JDBC驱动获取与注意事项达梦数据库的JDBC驱动并不像MySQL驱动那样可以直接从Maven中央仓库获取。这是第一个需要注意的点。官方获取途径你需要从达梦数据库的官方网站下载安装包或驱动包。通常在安装达梦数据库后在其安装目录的/drivers/jdbc路径下可以找到JAR文件例如DmJdbcDriver18.jar。请务必确认驱动版本与你的达梦数据库服务器版本相匹配使用不匹配的驱动可能会导致连接失败或出现不可预知的错误。手动引入项目由于不是中央仓库依赖我们需要手动将下载的DmJdbcDriver18.jar文件放入项目的lib目录如果没有可以新建然后在构建工具中引入。如果你使用Maven可以在项目根目录创建lib文件夹存放驱动JAR然后在pom.xml中通过system作用域引入dependency groupIdcom.dameng/groupId artifactIdDmJdbcDriver18/artifactId version8.1.1.49/version !-- 版本号请根据实际文件修改 -- scopesystem/scope systemPath${project.basedir}/lib/DmJdbcDriver18.jar/systemPath /dependency注意system作用域的依赖在打包时尤其是打可执行JAR包不会被自动包含进去。这对于Spring Boot应用是个大问题。更推荐的做法是使用maven-install-plugin将驱动安装到本地仓库或者使用公司内部的Nexus私服进行管理。安装到本地仓库的命令示例如下mvn install:install-file -Dfilelib/DmJdbcDriver18.jar -DgroupIdcom.dameng -DartifactIdDmJdbcDriver18 -Dversion8.1.1.49 -Dpackagingjar安装成功后就可以将上述依赖的scope改为compile或直接删除scope和systemPath配置。2.2 Spring Boot与Druid依赖配置接下来是引入Spring Boot和Druid的相关依赖。我们假设项目基于Spring Boot 2.x。parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version !-- 建议使用一个稳定的长期支持版本 -- relativePath/ /parent dependencies !-- Spring Boot Web Starter (根据你的项目类型选择) -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- Spring Boot JDBC Starter 它包含了spring-jdbc和事务管理等 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-jdbc/artifactId /dependency !-- Druid官方提供的Spring Boot Starter简化配置 -- dependency groupIdcom.alibaba/groupId artifactIddruid-spring-boot-starter/artifactId version1.2.20/version !-- 请使用最新稳定版 -- /dependency !-- 达梦驱动假设已安装到本地仓库 -- dependency groupIdcom.dameng/groupId artifactIdDmJdbcDriver18/artifactId version8.1.1.49/version /dependency !-- 其他项目依赖... -- /dependencies这里的关键是druid-spring-boot-starter它为我们提供了与Spring Boot配置属性文件application.yml或application.properties无缝集成的能力无需编写大量的Bean配置代码。3. 核心配置详解从连接URL到监控面板依赖就绪后核心工作就落在了配置文件上。我将分模块详细解释每个配置项的含义、针对达梦8的特殊设置以及如何避免常见陷阱。3.1 基础数据源与连接参数配置在application.yml中我们进行如下配置application.properties的写法类似按需转换spring: datasource: # 1. 指定数据源类型为 DruidDataSource type: com.alibaba.druid.pool.DruidDataSource # 2. 驱动类名这是达梦8的驱动 driver-class-name: dm.jdbc.driver.DmDriver # 3. 连接URL这是配置的关键 url: jdbc:dm://192.168.1.100:5236/DAMENG?schemaSYSDBAzeroDateTimeBehaviorconvertToNulluseUnicodetruecharacterEncodingutf-8 # 4. 用户名和密码 username: SYSDBA password: SYSDBA # 以下是Druid连接池的专属配置以 druid 为前缀 druid: # 5. 初始化连接数 initial-size: 5 # 6. 最小空闲连接数 min-idle: 5 # 7. 最大活跃连接数 max-active: 20 # 8. 获取连接时最大等待时间毫秒 max-wait: 60000 # 9. 配置间隔多久检测一次需要关闭的空闲连接毫秒 time-between-eviction-runs-millis: 60000 # 10. 连接在池中最小生存的时间毫秒 min-evictable-idle-time-millis: 300000 # 11. 验证连接是否有效的SQL validation-query: SELECT Hello FROM DUAL # 12. 申请连接时是否执行validationQuery检测 test-on-borrow: false # 13. 归还连接时是否执行validationQuery检测 test-on-return: false # 14. 空闲时是否执行validationQuery检测 test-while-idle: true针对达梦8的关键配置解析driver-class-name: 必须准确填写dm.jdbc.driver.DmDriver。有时网上老资料会写成dm.jdbc.driver.DmdbDriver这在DM8中已不适用务必确认。url: 这是最容易出错的地方。jdbc:dm://是达梦的JDBC协议头。192.168.1.100:5236是数据库服务器的IP和端口达梦默认端口是5236。DAMENG是数据库名在达梦安装时创建。schemaSYSDBA这个参数至关重要达梦数据库的模式Schema概念与用户强关联。SYSDBA是默认的超级管理员用户也是其默认模式。如果不指定连接后可能找不到属于该用户的表。这是与MySQL配置的一个显著区别。后面的zeroDateTimeBehaviorconvertToNulluseUnicodetruecharacterEncodingutf-8是我从MySQL配置习惯迁移过来的对于达梦characterEncoding通常是有效的但其他参数达梦驱动可能不支持或忽略不过写上一般也无害。更标准的达梦连接参数可以参考官方文档例如compatibleModemysql兼容模式等。validation-query: 连接有效性检测的SQL。对于达梦SELECT Hello FROM DUAL或SELECT 1都是可用的。DUAL是达梦中的虚拟表类似于Oracle。务必确保这个SQL语句简单且能在你的数据库上执行成功这是连接池健康检测的基础。3.2 监控配置与防火墙规则Druid的一大亮点就是内置了强大的监控功能。要启用监控统计和Web界面需要添加以下配置spring: datasource: druid: # 监控统计相关配置 # 15. 开启监控统计 web-stat-filter: enabled: true url-pattern: /* exclusions: *.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/* # 16. 开启StatViewServlet监控页面 stat-view-servlet: enabled: true url-pattern: /druid/* # 登录监控页面的用户名密码 login-username: admin login-password: admin123 # 是否允许重置监控数据 reset-enable: false # 允许访问的IP为空表示允许所有生产环境务必设置 allow: 127.0.0.1 # 拒绝访问的IP deny: # 17. 配置监控统计的过滤器 filter: stat: enabled: true # 合并多个相同的SQL merge-sql: true # 记录慢SQL的阈值毫秒 slow-sql-millis: 2000 log-slow-sql: true wall: enabled: true # 开启SQL防火墙防注入 config: enabled: true # 支持个性化的过滤器配置配置要点与避坑url-pattern:web-stat-filter的url-pattern通常设置为/*以统计所有Web请求。而stat-view-servlet的url-pattern设置为/druid/*这意味着监控页面的访问地址是http://你的应用地址:端口/druid/index.html。登录安全login-username和login-password在生产环境下必须修改并且要设置强密码避免监控信息泄露。访问控制allow和deny用于IP白名单和黑名单控制。在生产环境中强烈建议将allow设置为运维或管理员机器的IP禁止公网直接访问。reset-enable建议设为false防止误操作清空宝贵的监控数据。慢SQL监控slow-sql-millis定义了慢查询的阈值结合log-slow-sql: true可以在Druid监控页面的“SQL监控”中直接看到慢SQL语句和执行时间是性能调优的利器。3.3 达梦8特有的配置调优建议不同的数据库对连接池的行为可能有细微差别针对达梦8我推荐以下调优配置spring: datasource: druid: # 连接属性以键值对形式传递给JDBC驱动 connection-properties: druid.stat.mergeSqltrue;druid.stat.slowSqlMillis2000;config.decryptfalse # 物理连接创建时的初始化SQL可用于设置会话级变量 connection-init-sqls: SET SCHEMA SYSDBA # 是否缓存PreparedStatementPSCache。达梦对游标支持较好可以开启以提升性能。 pool-prepared-statements: true # PSCache的大小 max-pool-prepared-statement-per-connection-size: 20connection-init-sqls: 这个配置非常有用。它会在每个物理连接被创建后、放入连接池之前执行。这里我们设置为SET SCHEMA SYSDBA可以确保从连接池取出的连接默认就在SYSDBA模式下避免在代码中每次操作都要指定模式名。这对于多租户或需要切换Schema的场景是必备配置。pool-prepared-statements: 开启预编译语句缓存。对于需要反复执行相同SQL模板参数不同的场景如批量操作能显著提升性能。达梦数据库支持此特性建议开启。max-pool-prepared-statement-per-connection-size: 每个连接上缓存的预编译语句数量。需要根据应用SQL的多样性进行调整太小可能缓存命中率低太大则占用内存。4. 启动验证与深度问题排查配置完成后启动Spring Boot应用。如果控制台没有报出数据库连接相关的错误并且能看到类似DruidDataSource已初始化的日志那么基础连接就成功了。4.1 访问监控页面进行验证在浏览器中访问http://localhost:你的应用端口/druid/index.html输入配置的用户名和密码如admin/admin123。如果成功进入你会看到Druid强大的监控面板包括数据源可以看到连接池的活跃连接数、等待线程数等实时状态。SQL监控所有执行过的SQL及其执行时间、读取行数等统计信息慢SQL会高亮显示。SQL防火墙展示被防火墙拦截的SQL尝试。Web应用展示URI请求的监控数据。如果无法访问监控页面请按以下步骤排查检查配置是否生效首先确认stat-view-servlet.enabled是否为true且url-pattern配置正确。检查Spring Security等安全框架如果你的项目引入了Spring Security、Shiro等安全框架它们可能会拦截/druid/*路径。你需要在安全配置中为Druid的监控路径放行。例如在Spring Security配置中Override protected void configure(HttpSecurity http) throws Exception { http.authorizeRequests() .antMatchers(/druid/**).permitAll() // 放行Druid监控路径 .anyRequest().authenticated() .and().formLogin(); }检查过滤器顺序如果项目中有自定义的Filter可能会影响Druid的StatFilter。确保Druid的过滤器被正确注册。4.2 连接泄漏与活跃连接数异常排查在监控页面的“数据源”选项卡如果发现“活跃连接数”Active Count持续增长且不下降甚至接近max-active而“执行查询”的并发并不高这很可能发生了连接泄漏。连接泄漏的典型原因和排查方法未正确关闭连接或ResultSet、Statement这是最常见的原因。虽然我们使用Spring的JdbcTemplate或MyBatis等框架它们通常会帮我们管理连接但在某些手动获取连接的场景如复杂事务、多数据源必须确保在finally块中调用connection.close()实际上是将连接归还给连接池。排查检查代码中所有DataSourceUtils.getConnection()、dataSource.getConnection()的地方是否都有对应的释放操作。使用try-with-resources语法是很好的习惯。事务未及时提交或回滚一个长时间运行且未结束的事务会一直占用一个连接。排查检查业务逻辑中事务的边界是否合理。避免在事务中进行远程调用、文件IO等耗时操作。可以使用Transactional(timeout 秒数)设置事务超时。Druid配置不当validation-query设置错误或数据库网络不稳定导致连接池误判连接失效不断创建新连接。排查将test-on-borrow设为true可以更严格地检测但会牺牲一点性能。同时确保网络稳定并优化validation-query。利用Druid监控定位泄漏点在监控页面“连接池”详情里Druid有时会直接提示疑似泄漏的连接堆栈。开启Druid的“移除长时间不关闭连接”的日志。在配置中添加spring: datasource: druid: remove-abandoned: true # 是否移除泄露的连接 remove-abandoned-timeout: 300 # 泄露连接的超时时间秒 log-abandoned: true # 是否记录移除连接的日志当连接占用超过300秒未关闭Druid会强制回收并打印警告日志日志中会包含该连接被获取时的调用堆栈这是定位泄漏代码的黄金信息。4.3 达梦8与Druid兼容性深水区问题在一些特定场景下你可能会遇到更棘手的问题问题一监控页面的“SQL监控”中看不到任何SQL语句。原因Druid的SQL监控依赖于其内置的StatFilter。如果SQL执行没有经过这个过滤器就不会被统计。解决方案确保druid.filter.stat.enabledtrue。如果你使用了多个数据源需要为每个数据源单独配置DruidDataSourceBean并在Bean的setFilters属性中明确加入stat。对于druid-spring-boot-starter和单数据源通常会自动配置好。某些数据库操作比如通过Hibernate原生SQL查询或者一些非常底层的JDBC操作可能绕过了Spring的包装从而绕过了过滤器。这种情况需要检查代码路径。问题二连接池初始化失败报错“discard connection”或“communications link failure”。原因数据库服务器防火墙未开放5236端口达梦数据库服务未启动连接URL、用户名、密码错误或者达梦数据库的max_sessions最大会话数参数已满。排查使用数据库客户端工具如达梦的管理工具尝试连接验证网络和基础账号密码。检查达梦数据库的V$SESSIONS视图查看当前会话数。检查Druid的initial-size如果设置过大在数据库压力大时可能一次性创建连接失败。问题三执行一段时间后出现“连接已关闭”的错误。原因数据库服务端主动断开了空闲连接可能由于数据库的session_timeout或网络设备超时而Druid连接池并不知道仍然将失效的连接分配给应用。解决方案优化Druid的连接保活配置。spring: datasource: druid: test-while-idle: true # 必须为true time-between-eviction-runs-millis: 60000 # 检测间隔不宜过长如1分钟 min-evictable-idle-time-millis: 300000 # 最小空闲时间如5分钟 validation-query: SELECT 1 # 确保这个查询高效且正确这样配置后Druid会每隔60秒检测一次空闲时间超过5分钟的连接并用validation-query测试其有效性无效则丢弃并创建新的。5. 生产环境部署的进阶考量当应用准备上生产时关于Druid和达梦8的配置还需要从运维和安全的视角进行加固。5.1 配置加密与敏感信息保护在application.yml中明文存储数据库密码是极不安全的。Druid支持对密码进行加密。生成加密密码使用Druid自带的com.alibaba.druid.filter.config.ConfigTools类进行加密。java -cp druid-1.2.20.jar com.alibaba.druid.filter.config.ConfigTools 你的明文密码命令会输出公钥publicKey和加密后的密码password。修改配置文件spring: datasource: password: {加密后的密码字符串} druid: connection-properties: config.decrypttrue;config.decrypt.key{你的公钥字符串} filter: config: enabled: true # 必须启用config过滤器这样Druid在启动时会使用配置的公钥对加密的密码进行解密。5.2 多数据源与读写分离配置在微服务或复杂应用中可能需要连接多个达梦数据库实例或者配置读写分离。多数据源配置核心思路你需要创建多个DataSourceBean并分别指定它们的Druid配置。同时需要使用Primary注解指定一个主数据源。这里的关键是每个数据源的Druid监控过滤器需要独立配置。Configuration public class DataSourceConfig { Primary Bean(name masterDataSource) ConfigurationProperties(prefix spring.datasource.druid.master) public DataSource masterDataSource() { return DruidDataSourceBuilder.create().build(); } Bean(name slaveDataSource) ConfigurationProperties(prefix spring.datasource.druid.slave) public DataSource slaveDataSource() { return DruidDataSourceBuilder.create().build(); } // 如果需要可以在这里配置动态数据源路由如使用AbstractRoutingDataSource }对应的application.yml配置spring: datasource: type: com.alibaba.druid.pool.DruidDataSource druid: master: url: jdbc:dm://master-host:5236/DAMENG username: master_user password: master_pwd driver-class-name: dm.jdbc.driver.DmDriver initial-size: 5 # ... 其他master专属配置 filters: stat,wall,config # 为master数据源显式指定过滤器 slave: url: jdbc:dm://slave-host:5236/DAMENG username: slave_user password: slave_pwd driver-class-name: dm.jdbc.driver.DmDriver initial-size: 3 # ... 其他slave专属配置 filters: stat,wall,config # 为slave数据源显式指定过滤器 # 全局的web-stat-filter和stat-view-servlet通常只需一份它们基于Servlet上下文不绑定特定数据源 web-stat-filter: enabled: true url-pattern: /* stat-view-servlet: enabled: true url-pattern: /druid/*5.3 监控集成与告警Druid的监控数据可以通过JMX暴露出来方便与公司现有的监控系统如Prometheus Grafana, Zabbix集成。开启JMX在JVM启动参数中添加-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port你的端口 -Dcom.sun.management.jmxremote.sslfalse -Dcom.sun.management.jmxremote.authenticatefalse生产环境请启用认证和SSL。使用JMX Exporter对于Prometheus可以使用jmx_exporter来抓取Druid MBean的数据。你需要配置一个config.yaml文件定义要收集的MBean指标。关键监控指标activeCount: 活跃连接数。持续高位报警。waitThreadCount: 等待获取连接的线程数。大于0且持续增长说明连接池可能成为瓶颈。connectCount: 总连接创建次数。异常飙升可能意味着连接泄漏或数据库重启。errorCount: 错误次数。将这些指标可视化并设置合理的告警阈值例如活跃连接数超过max-active的80%就告警是保障生产系统稳定的重要一环。6. 性能调优实战从参数到SQL配置正确只是第一步要让“Druid 达梦8”的组合发挥最佳性能还需要进行精细化的调优。6.1 连接池参数调优公式与思路连接池参数没有银弹需要根据实际压力测试结果调整。以下是一个基于经验的调优思路max-active(最大连接数)这是最重要的参数。理论最大值受数据库服务器max_connections限制通常设置为该值的70%-80%为系统其他应用或管理会话留出空间。应用端估算一个粗略的估算公式是max-active Tn / (Tc * (1 - Tt))。其中Tn是应用平均每秒事务数Tc是每个事务平均耗时秒Tt是事务耗时中数据库操作所占比例。但这很难精确计算。压力测试法最可靠的方法。在模拟生产压力的测试中逐步增加并发用户数观察应用响应时间和数据库负载。当响应时间开始非线性增长或数据库CPU/连接数达到瓶颈时当时的活跃连接数就是max-active的参考值。初始值可以设置为20-50。min-idle(最小空闲连接)保持一定数量的“热”连接避免突发请求时频繁创建连接的开销。通常设置为max-active的10%-20%或根据应用低谷期的流量确定。不宜设置过大否则会浪费数据库资源。max-wait(获取连接超时时间)当连接池耗尽时应用线程等待获取连接的最长时间。超过则抛异常。根据业务容忍度设置一般设为3-10秒。设置过短会导致大量获取连接超时异常设置过长则线程堆积可能拖垮整个应用。time-between-eviction-runs-millis和min-evictable-idle-time-millis(连接逐出策略)time-between-eviction-runs-millis检测间隔。建议设置为min-evictable-idle-time-millis的1/3到1/2。例如空闲连接5分钟淘汰那么可以每1-2分钟检测一次。不宜过频增加开销也不宜过疏连接无效时间过长。min-evictable-idle-time-millis连接最小空闲时间。要略小于数据库服务器端会话超时时间。如果达梦数据库的session_timeout是10分钟这里可以设置为8-9分钟确保在数据库踢掉连接之前连接池自己先回收。6.2 利用Druid监控进行SQL层优化连接池调优解决的是“连接管理”的问题而数据库性能的瓶颈往往在SQL本身。Druid的“SQL监控”和“慢SQL日志”是定位问题SQL的绝佳工具。识别慢SQL在监控页面按照“执行时间”或“执行次数*平均时间”排序找出最耗资源的SQL。分析SQL模式关注是否出现大量相似SQL仅参数不同这可能是MyBatis等框架动态生成的SQL考虑是否可以使用sql标签复用或优化逻辑。结合达梦执行计划将Druid抓取到的慢SQL到达梦数据库中使用EXPLAIN命令查看其执行计划。重点关注全表扫描TABLE SCAN是否缺少必要的索引。索引选择不当达梦的优化器可能选择了不合适的索引。可以使用INDEX HINT进行强制索引测试。嵌套循环连接NESTED LOOP效率低下对于大数据集关联考虑是否适合使用哈希连接HASH JOIN或归并连接MERGE JOIN有时需要调整统计信息或使用优化器提示。关注结果集大小Druid会显示“读取行数”。如果一个查询返回了数万行但前端只显示10条那很可能需要优化SQL增加分页或过滤条件。6.3 达梦8特定性能配置联动除了连接池和SQL达梦数据库本身的配置也与性能息息相关需要与连接池配置联动考虑。会话参数可以通过Druid的connection-init-sqls为连接设置一些优化参数。例如connection-init-sqls: SET SCHEMA SYSDBA; SET OPTIMIZER_MODE1这里OPTIMIZER_MODE1是达梦的一种优化器模式。但要注意这些设置是会话级的对全局影响需要谨慎评估。最好在数据库管理员指导下进行。游标缓存达梦的CURSOR_CACHE_SIZE参数会影响游标缓存。如果应用使用了大量可滚动的结果集或存储过程返回游标适当调整此参数可能有益。但这属于数据库服务器端调优与应用连接池配置间接相关。经过以上从基础配置到生产调优的全流程梳理相信你已经能够驾驭“阿里Druid连接池配置达梦8”这个任务。记住所有配置的最佳值都源于对自身应用行为和数据库负载的持续观察与测试。开始时可以使用保守的默认值上线后结合Druid监控提供的数据进行小步快跑式的迭代优化最终让这套组合在你的生产环境中稳定高效地运行。