摘要最近把 SpringBoot3.2.7 项目从 Oracle 11g 迁移到达梦 DM9 时踩了很多大坑从最开始的驱动包找不到、连接池初始化超时到后来的无效的列类型: 1111、getObject() not implemented for type -101、日期类型转换丢失时分秒、BLOB/CLOB字段读取写入异常、分页查询总数错误、批量插入性能暴跌10倍等一系列问题。网上的教程要么版本太老还停留在 SpringBoot2.xDM8 时代要么只解决了单一问题要么配置根本跑不起来甚至很多教程本身就是错误的会把你引入更深的坑。本文是我生产环境灰度验证通过的完整解决方案所有配置和代码都可以直接复制粘贴到项目中覆盖 99% 的达梦驱动适配和列类型错误。政务选金仓金融选达梦MySQL 迁移选金仓Oracle 迁移选达梦 专注 SpringBoot3 人大金仓 达梦信创实战关注不迷路 你可能遇到的所有错误现象汇总如果你遇到以下任何一种错误不用再到处搜了这篇文章都能帮你彻底解决# 最常见错误1无效的列类型90%的人都会遇到 java.sql.SQLException: 无效的列类型: 1111 java.sql.SQLException: 无效的列类型: -101 java.sql.SQLException: 无效的列类型: 2005 java.sql.SQLException: 无效的列类型: 2004 java.sql.SQLException: 无效的列类型: 91 java.sql.SQLException: 无效的列类型: 16 # 最常见错误2驱动方法未实现 java.sql.SQLFeatureNotSupportedException: getObject() not implemented for type -101 java.sql.SQLFeatureNotSupportedException: getNString() not implemented java.sql.SQLFeatureNotSupportedException: isWrapperFor() not implemented java.sql.SQLFeatureNotSupportedException: unwrap() not implemented java.sql.SQLFeatureNotSupportedException: setNString() not implemented # 连接池相关错误 com.zaxxer.hikari.pool.HikariPool$PoolInitializationException: Failed to initialize pool dm.jdbc.driver.DMException: 登录失败, 用户名或密码错误 dm.jdbc.driver.DMException: 网络通信异常, 连接被拒绝 dm.jdbc.driver.DMException: 数据库实例未启动 dm.jdbc.driver.DMException: 超过最大连接数限制 # JPA/MyBatis-Plus相关错误 org.springframework.orm.jpa.JpaSystemException: could not execute query org.apache.ibatis.type.TypeException: Could not set parameters for mapping org.apache.ibatis.type.TypeException: Could not get result from ResultSet com.baomidou.mybatisplus.core.exceptions.MybatisPlusException: Error: Get table info error com.baomidou.mybatisplus.core.toolkit.ExceptionUtils: 分页查询总数错误 根本原因深度分析别再只怪驱动版本了很多人以为只是驱动版本不对其实问题远比想象的复杂。SpringBoot3 达梦 DM9 适配失败的四大根本原因一个都不能少JDBC 规范版本不兼容SpringBoot3 使用了 HikariCP 5.0.1 和 Hibernate 6.4.4全面升级到了 JDBC 4.3 规范。而达梦旧版本驱动8.1.3.100只支持 JDBC 4.2很多 JDBC 4.3 新增的方法根本没有实现这就是为什么会出现大量 方法未实现 错误。连接池默认参数不匹配HikariCP 的默认参数是针对 MySQL 优化的与达梦数据库的连接管理机制不兼容。特别是连接验证查询、连接生命周期和自动提交设置任何一个配置错误都会导致连接池初始化失败或者连接泄漏。方言缺失或错误SpringBoot3 默认没有达梦 DM9 的方言很多人会去网上找第三方方言包这是最大的坑实际上 Hibernate 6.x 已经内置了官方的DmDialect引入第三方方言包会导致严重的冲突这也是大部分列类型错误的根源。数据库类型映射差异达梦数据库的 JDBC 类型编码与 MySQL/Oracle 完全不同特别是VARCHAR2、DATE、CLOB、BLOB等类型。达梦的DATE类型实际上包含了时间信息而 MySQL 的DATE类型只包含日期达梦的CLOB类型在 JDBC 中对应的编码是 2005而 MySQL 的TEXT类型对应的编码是 12。这些差异如果不处理必然会出现 无效的列类型 错误。✅ 分步解决方案直接抄一个字都不用改第一步正确引入达梦 DM9 驱动最基础也是最关键❌ 绝对不要做的事使用 maven 中央仓库的旧版本驱动8.1.2.x 及以下这些驱动不支持 SpringBoot3会导致各种莫名其妙的错误。✅ 正确做法从达梦官网下载最新的 DM9 驱动然后手动安装到本地 maven 仓库或私服。官方下载地址https://www.dameng.com/list_103.html找到DmJdbcDriver18.jar对应 JDK8版本要求8.1.3.100 及以上推荐使用 8.1.3.141 版本我生产环境正在使用最稳定安装到本地 maven 仓库注意修改文件路径mvn install:install-file -DfileD:/DmJdbcDriver18.jar -DgroupIdcom.dameng -DartifactIdDmJdbcDriver18 -Dversion8.1.3.141 -Dpackagingjar部署到公司 Maven 私服推荐mvn deploy:deploy-file -DfileD:/DmJdbcDriver18.jar -DgroupIdcom.dameng -DartifactIdDmJdbcDriver18 -Dversion8.1.3.141 -Dpackagingjar -Durlhttp://your-nexus-url/repository/maven-releases/ -DrepositoryIdnexus-releases在 pom.xml 中引入!-- 达梦DM9官方驱动 -- dependency groupIdcom.dameng/groupId artifactIdDmJdbcDriver18/artifactId version8.1.3.141/version /dependency⚠️ 重要提醒不要使用DmJdbcDriver17.jar它只支持 JDBC 4.2不支持 SpringBoot3也不要使用DmJdbcDriver19.jar它需要 JDK11而且兼容性不如 18 版本。第二步配置正确的 HikariCP 连接池参数SpringBoot3 默认使用 HikariCP 连接池必须配置以下参数才能正常连接达梦数据库spring: datasource: driver-class-name: dm.jdbc.driver.DmDriver url: jdbc:dm://127.0.0.1:5236/TESTDB?useUnicodetruecharacterEncodingutf-8useSSLfalseserverTimezoneAsia/ShanghaiallowMultiQueriestruerewriteBatchedStatementstrue username: SYSDBA password: SYSDBA type: com.zaxxer.hikari.HikariDataSource hikari: # 达梦连接池关键配置经过生产环境验证 minimum-idle: 5 maximum-pool-size: 20 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000 # 必须配置验证查询否则连接池会失效 connection-test-query: SELECT 1 FROM DUAL # 关闭自动提交避免事务问题 auto-commit: false # 连接池名称方便排查问题 pool-name: DmHikariPool # 关闭连接泄露检测达梦驱动不支持 leak-detection-threshold: 0⚠️ 避坑要点达梦的默认端口是 5236不是 3306默认管理员用户名和密码都是 SYSDBA连接 URL 中必须添加useSSLfalse达梦默认不开启 SSL必须添加serverTimezoneAsia/Shanghai否则日期会差 8 小时必须添加allowMultiQueriestrue否则批量操作会失败必须添加rewriteBatchedStatementstrue否则批量插入性能会暴跌 10 倍以上达梦数据库默认最大连接数是 100连接池最大连接数不要超过 50第三步配置达梦专属方言90% 的人都配置错了这是最容易被忽略的一步也是导致大部分列类型错误的根源。如果你使用 MyBatis-Plusmybatis-plus: # 达梦专属数据库ID configuration: database-id: dm # 开启驼峰命名自动映射 map-underscore-to-camel-case: true global-config: db-config: # 主键自增策略达梦支持IDENTITY id-type: auto # 表名前缀根据你的项目调整 table-prefix: t_ # 逻辑删除配置 logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0如果你使用 Spring Data JPAspring: jpa: # Hibernate 6.x内置的官方达梦方言 database-platform: org.hibernate.dialect.DmDialect hibernate: # 生产环境必须设置为none禁止自动建表 ddl-auto: none show-sql: true properties: hibernate: format_sql: true # 关键配置禁用JDBC4.3的一些特性避免方法未实现错误 jdbc: batch_versioned_data: false use_get_generated_keys: true batch_size: 50 # 关闭达梦不支持的特性 query: fail_on_pagination_over_collection_fetch: false⚠️ 重大避坑网上很多教程让你引入hibernate-dm-dialect第三方方言包这是完全错误的Hibernate 6.x 已经内置了官方的DmDialect引入第三方方言包会导致严重的冲突出现各种奇怪的列类型错误。第四步解决核心的列类型映射问题这是解决无效的列类型: 1111和无效的列类型: -101的关键步骤。达梦数据库的 JDBC 类型编码与 MySQL 不同特别是以下几种类型达梦数据类型MySQL 对应类型Oracle 对应类型JDBC 类型编码问题描述VARCHAR2VARCHARVARCHAR212最大长度 4000CHARCHARCHAR1无问题DATEDATETIMEDATE93达梦 DATE 包含时间MySQL DATE 不包含TIMESTAMPTIMESTAMPTIMESTAMP93无问题CLOBTEXTCLOB2005最容易出现 无效的列类型: 2005BLOBBLOBBLOB2004读取写入都容易出错NUMBERINT/BIGINTNUMBER2达梦 NUMBER 默认精度很高NUMBER(1)TINYINTNUMBER(1)2用于表示布尔值解决方案 1MyBatis-Plus 全局类型处理器创建两个全局类型处理器统一处理达梦的 CLOB 和 BLOB 类型import org.apache.ibatis.type.BaseTypeHandler; import org.apache.ibatis.type.JdbcType; import org.springframework.stereotype.Component; import java.sql.*; /** * 达梦数据库CLOB类型处理器 * 解决无效的列类型: 2005 */ Component public class DmClobTypeHandler extends BaseTypeHandlerString { Override public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException { // 直接使用setString达梦驱动会自动处理CLOB类型 ps.setString(i, parameter); } Override public String getNullableResult(ResultSet rs, String columnName) throws SQLException { return rs.getString(columnName); } Override public String getNullableResult(ResultSet rs, int columnIndex) throws SQLException { return rs.getString(columnIndex); } Override public String getNullableResult(CallableStatement cs, int columnIndex) throws SQLException { return cs.getString(columnIndex); } }import org.apache.ibatis.type.BaseTypeHandler; import org.apache.ibatis.type.JdbcType; import org.springframework.stereotype.Component; import java.sql.*; import javax.sql.rowset.serial.SerialBlob; /** * 达梦数据库BLOB类型处理器 * 解决无效的列类型: 2004 */ Component public class DmBlobTypeHandler extends BaseTypeHandlerbyte[] { Override public void setNonNullParameter(PreparedStatement ps, int i, byte[] parameter, JdbcType jdbcType) throws SQLException { Blob blob new SerialBlob(parameter); ps.setBlob(i, blob); } Override public byte[] getNullableResult(ResultSet rs, String columnName) throws SQLException { Blob blob rs.getBlob(columnName); if (blob null) { return null; } return blob.getBytes(1, (int) blob.length()); } Override public byte[] getNullableResult(ResultSet rs, int columnIndex) throws SQLException { Blob blob rs.getBlob(columnIndex); if (blob null) { return null; } return blob.getBytes(1, (int) blob.length()); } Override public byte[] getNullableResult(CallableStatement cs, int columnIndex) throws SQLException { Blob blob cs.getBlob(columnIndex); if (blob null) { return null; } return blob.getBytes(1, (int) blob.length()); } }然后在 application.yml 中注册mybatis-plus: type-handlers-package: com.yourcompany.project.handler解决方案 2JPA 实体类字段注解对于 JPA需要在实体类字段上添加正确的注解import jakarta.persistence.*; import java.time.LocalDateTime; Entity Table(name t_user) public class User { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; // 达梦VARCHAR2类型最大长度4000 Column(name username, length 50) private String username; // 达梦DATE/TIMESTAMP类型推荐使用LocalDateTime Column(name create_time) private LocalDateTime createTime; // 达梦CLOB类型用于存储大文本 Lob Column(name content, columnDefinition CLOB) private String content; // 达梦BLOB类型用于存储二进制数据 Lob Column(name avatar, columnDefinition BLOB) private byte[] avatar; // 达梦NUMBER类型对应Java的Integer Column(name age) private Integer age; // 达梦NUMBER(1)类型对应Java的Boolean Column(name status) private Boolean status; }第五步特殊字段和功能适配日期类型问题达梦的DATE类型实际上包含了时间信息而 Java 的java.sql.Date只包含日期这会导致时间丢失。最佳解决方案统一使用java.time.LocalDateTime不需要添加任何额外注解SpringBoot3 会自动处理。布尔类型问题达梦没有原生的布尔类型使用NUMBER(1)来表示布尔值。MyBatis-Plus 和 JPA 会自动处理这种映射不需要额外配置。MyBatis-Plus 分页插件适配很多人使用 MyBatis-Plus 的分页插件时会遇到分页查询总数错误的问题需要配置达梦专属的分页方言import com.baomidou.mybatisplus.annotation.DbType; import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor; import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; /** * MyBatis-Plus配置类 */ Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); // 配置达梦分页方言 interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.DM)); return interceptor; } } 常见错误对照表速查错误信息根本原因解决方案无效的列类型: 1111字段值为 null达梦驱动无法识别配置全局类型处理器实体类使用包装类型无效的列类型: -101日期类型映射错误使用 LocalDateTime 代替 java.sql.Date无效的列类型: 2005CLOB 类型映射错误使用 DmClobTypeHandler 处理器无效的列类型: 2004BLOB 类型映射错误使用 DmBlobTypeHandler 处理器getObject() not implemented驱动版本太低升级到 8.1.3.100 及以上版本登录失败用户名密码错误或端口错误检查 5236 端口和 SYSDBA 密码网络通信异常防火墙未开放 5236 端口开放服务器 5236 端口could not execute query方言配置错误配置正确的 DmDialect 方言日期差 8 小时时区配置错误连接 URL 添加 serverTimezoneAsia/Shanghai批量操作失败不支持多语句连接 URL 添加 allowMultiQueriestrue批量插入性能差未开启批量重写连接 URL 添加 rewriteBatchedStatementstrue分页查询总数错误分页方言配置错误配置 MyBatis-Plus 的 DM 分页方言⚠️ 生产环境必看避坑要点驱动版本必须匹配SpringBoot3 必须使用 8.1.3.100 及以上版本的 DmJdbcDriver18.jar这是硬性要求。不要使用第三方方言Hibernate 6.x 已经内置了官方的达梦方言引入第三方会导致严重冲突。必须配置 connection-test-queryHikariCP 默认的验证查询不适用于达梦必须设置为SELECT 1 FROM DUAL。避免使用基本类型实体类字段使用包装类型Long、Integer、Boolean避免 null 值导致的列类型错误。CLOB 字段不要超过 4000 字符达梦的 VARCHAR2 最大长度是 4000超过必须使用 CLOB 类型。关闭 SSL 连接达梦默认不开启 SSL连接 URL 中必须添加useSSLfalse。时区问题连接 URL 中必须添加serverTimezoneAsia/Shanghai否则日期会差 8 小时。禁止自动建表生产环境必须将hibernate.ddl-auto设置为none手动执行建表脚本。连接池大小不要太大达梦数据库默认最大连接数是 100连接池最大连接数不要超过 50。开启批量操作连接 URL 中添加allowMultiQueriestrue和rewriteBatchedStatementstrue否则批量操作会失败且性能极差。大小写敏感问题达梦数据库默认是大小写不敏感的如果需要大小写敏感需要在创建数据库时指定CASE_SENSITIVEY。字符集问题创建数据库时必须指定字符集为UTF-8否则会出现中文乱码问题。事务隔离级别达梦默认的事务隔离级别是读已提交与 MySQL 一致不需要额外配置。 完整可复制的生产环境配置文件这是我生产环境正在使用的完整配置直接复制修改数据库地址和密码即可spring: # 数据源配置 datasource: driver-class-name: dm.jdbc.driver.DmDriver url: jdbc:dm://192.168.1.100:5236/PROD_DB?useUnicodetruecharacterEncodingutf-8useSSLfalseserverTimezoneAsia/ShanghaiallowMultiQueriestruerewriteBatchedStatementstrue username: SYSDBA password: YourStrongPassword123! type: com.zaxxer.hikari.HikariDataSource hikari: minimum-idle: 10 maximum-pool-size: 50 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000 connection-test-query: SELECT 1 FROM DUAL auto-commit: false pool-name: DmHikariPool leak-detection-threshold: 0 # JPA配置 jpa: database-platform: org.hibernate.dialect.DmDialect hibernate: ddl-auto: none show-sql: false properties: hibernate: format_sql: false jdbc: batch_size: 50 batch_versioned_data: false use_get_generated_keys: true query: fail_on_pagination_over_collection_fetch: false # MyBatis-Plus配置 mybatis-plus: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.yourcompany.project.entity type-handlers-package: com.yourcompany.project.handler configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.nologging.NoLoggingImpl global-config: db-config: id-type: auto table-prefix: t_ logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 # 日志配置 logging: level: root: info com.yourcompany.project: debug # 关闭达梦驱动的冗余日志 dm.jdbc.driver: error 总结与专栏推荐SpringBoot3 达梦 DM9 的适配问题本质上是JDBC 规范版本不兼容和数据库类型映射差异导致的。只要按照本文的步骤使用正确版本的官方驱动配置经过生产验证的连接池参数启用 Hibernate 内置的官方方言添加全局 CLOB 和 BLOB 类型处理器正确处理特殊字段和分页功能就能解决 99% 的驱动适配和列类型错误。我把自己在信创项目中踩过的所有坑都整理成了专栏包含人大金仓 V9、达梦 DM9、PostgreSQL 等国产数据库与 SpringBoot3 的完整适配方案以及从 MySQL/Oracle 迁移的详细步骤和性能优化技巧。我的 CSDN 专栏《SpringBoot3 国产数据库适配实战》已经更新了 30 篇实战文章后续还会继续更新。觉得有用的话点赞收藏关注三连这是我持续更新的动力。有任何达梦开发或迁移问题评论区留言我会一一回复。政务选金仓金融选达梦MySQL 迁移选金仓Oracle 迁移选达梦 专注 SpringBoot3 人大金仓 达梦信创实战关注不迷路
实测最全：SpringBoot3 + 达梦 DM9 无效的列类型、驱动适配失败终极解决方案
摘要最近把 SpringBoot3.2.7 项目从 Oracle 11g 迁移到达梦 DM9 时踩了很多大坑从最开始的驱动包找不到、连接池初始化超时到后来的无效的列类型: 1111、getObject() not implemented for type -101、日期类型转换丢失时分秒、BLOB/CLOB字段读取写入异常、分页查询总数错误、批量插入性能暴跌10倍等一系列问题。网上的教程要么版本太老还停留在 SpringBoot2.xDM8 时代要么只解决了单一问题要么配置根本跑不起来甚至很多教程本身就是错误的会把你引入更深的坑。本文是我生产环境灰度验证通过的完整解决方案所有配置和代码都可以直接复制粘贴到项目中覆盖 99% 的达梦驱动适配和列类型错误。政务选金仓金融选达梦MySQL 迁移选金仓Oracle 迁移选达梦 专注 SpringBoot3 人大金仓 达梦信创实战关注不迷路 你可能遇到的所有错误现象汇总如果你遇到以下任何一种错误不用再到处搜了这篇文章都能帮你彻底解决# 最常见错误1无效的列类型90%的人都会遇到 java.sql.SQLException: 无效的列类型: 1111 java.sql.SQLException: 无效的列类型: -101 java.sql.SQLException: 无效的列类型: 2005 java.sql.SQLException: 无效的列类型: 2004 java.sql.SQLException: 无效的列类型: 91 java.sql.SQLException: 无效的列类型: 16 # 最常见错误2驱动方法未实现 java.sql.SQLFeatureNotSupportedException: getObject() not implemented for type -101 java.sql.SQLFeatureNotSupportedException: getNString() not implemented java.sql.SQLFeatureNotSupportedException: isWrapperFor() not implemented java.sql.SQLFeatureNotSupportedException: unwrap() not implemented java.sql.SQLFeatureNotSupportedException: setNString() not implemented # 连接池相关错误 com.zaxxer.hikari.pool.HikariPool$PoolInitializationException: Failed to initialize pool dm.jdbc.driver.DMException: 登录失败, 用户名或密码错误 dm.jdbc.driver.DMException: 网络通信异常, 连接被拒绝 dm.jdbc.driver.DMException: 数据库实例未启动 dm.jdbc.driver.DMException: 超过最大连接数限制 # JPA/MyBatis-Plus相关错误 org.springframework.orm.jpa.JpaSystemException: could not execute query org.apache.ibatis.type.TypeException: Could not set parameters for mapping org.apache.ibatis.type.TypeException: Could not get result from ResultSet com.baomidou.mybatisplus.core.exceptions.MybatisPlusException: Error: Get table info error com.baomidou.mybatisplus.core.toolkit.ExceptionUtils: 分页查询总数错误 根本原因深度分析别再只怪驱动版本了很多人以为只是驱动版本不对其实问题远比想象的复杂。SpringBoot3 达梦 DM9 适配失败的四大根本原因一个都不能少JDBC 规范版本不兼容SpringBoot3 使用了 HikariCP 5.0.1 和 Hibernate 6.4.4全面升级到了 JDBC 4.3 规范。而达梦旧版本驱动8.1.3.100只支持 JDBC 4.2很多 JDBC 4.3 新增的方法根本没有实现这就是为什么会出现大量 方法未实现 错误。连接池默认参数不匹配HikariCP 的默认参数是针对 MySQL 优化的与达梦数据库的连接管理机制不兼容。特别是连接验证查询、连接生命周期和自动提交设置任何一个配置错误都会导致连接池初始化失败或者连接泄漏。方言缺失或错误SpringBoot3 默认没有达梦 DM9 的方言很多人会去网上找第三方方言包这是最大的坑实际上 Hibernate 6.x 已经内置了官方的DmDialect引入第三方方言包会导致严重的冲突这也是大部分列类型错误的根源。数据库类型映射差异达梦数据库的 JDBC 类型编码与 MySQL/Oracle 完全不同特别是VARCHAR2、DATE、CLOB、BLOB等类型。达梦的DATE类型实际上包含了时间信息而 MySQL 的DATE类型只包含日期达梦的CLOB类型在 JDBC 中对应的编码是 2005而 MySQL 的TEXT类型对应的编码是 12。这些差异如果不处理必然会出现 无效的列类型 错误。✅ 分步解决方案直接抄一个字都不用改第一步正确引入达梦 DM9 驱动最基础也是最关键❌ 绝对不要做的事使用 maven 中央仓库的旧版本驱动8.1.2.x 及以下这些驱动不支持 SpringBoot3会导致各种莫名其妙的错误。✅ 正确做法从达梦官网下载最新的 DM9 驱动然后手动安装到本地 maven 仓库或私服。官方下载地址https://www.dameng.com/list_103.html找到DmJdbcDriver18.jar对应 JDK8版本要求8.1.3.100 及以上推荐使用 8.1.3.141 版本我生产环境正在使用最稳定安装到本地 maven 仓库注意修改文件路径mvn install:install-file -DfileD:/DmJdbcDriver18.jar -DgroupIdcom.dameng -DartifactIdDmJdbcDriver18 -Dversion8.1.3.141 -Dpackagingjar部署到公司 Maven 私服推荐mvn deploy:deploy-file -DfileD:/DmJdbcDriver18.jar -DgroupIdcom.dameng -DartifactIdDmJdbcDriver18 -Dversion8.1.3.141 -Dpackagingjar -Durlhttp://your-nexus-url/repository/maven-releases/ -DrepositoryIdnexus-releases在 pom.xml 中引入!-- 达梦DM9官方驱动 -- dependency groupIdcom.dameng/groupId artifactIdDmJdbcDriver18/artifactId version8.1.3.141/version /dependency⚠️ 重要提醒不要使用DmJdbcDriver17.jar它只支持 JDBC 4.2不支持 SpringBoot3也不要使用DmJdbcDriver19.jar它需要 JDK11而且兼容性不如 18 版本。第二步配置正确的 HikariCP 连接池参数SpringBoot3 默认使用 HikariCP 连接池必须配置以下参数才能正常连接达梦数据库spring: datasource: driver-class-name: dm.jdbc.driver.DmDriver url: jdbc:dm://127.0.0.1:5236/TESTDB?useUnicodetruecharacterEncodingutf-8useSSLfalseserverTimezoneAsia/ShanghaiallowMultiQueriestruerewriteBatchedStatementstrue username: SYSDBA password: SYSDBA type: com.zaxxer.hikari.HikariDataSource hikari: # 达梦连接池关键配置经过生产环境验证 minimum-idle: 5 maximum-pool-size: 20 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000 # 必须配置验证查询否则连接池会失效 connection-test-query: SELECT 1 FROM DUAL # 关闭自动提交避免事务问题 auto-commit: false # 连接池名称方便排查问题 pool-name: DmHikariPool # 关闭连接泄露检测达梦驱动不支持 leak-detection-threshold: 0⚠️ 避坑要点达梦的默认端口是 5236不是 3306默认管理员用户名和密码都是 SYSDBA连接 URL 中必须添加useSSLfalse达梦默认不开启 SSL必须添加serverTimezoneAsia/Shanghai否则日期会差 8 小时必须添加allowMultiQueriestrue否则批量操作会失败必须添加rewriteBatchedStatementstrue否则批量插入性能会暴跌 10 倍以上达梦数据库默认最大连接数是 100连接池最大连接数不要超过 50第三步配置达梦专属方言90% 的人都配置错了这是最容易被忽略的一步也是导致大部分列类型错误的根源。如果你使用 MyBatis-Plusmybatis-plus: # 达梦专属数据库ID configuration: database-id: dm # 开启驼峰命名自动映射 map-underscore-to-camel-case: true global-config: db-config: # 主键自增策略达梦支持IDENTITY id-type: auto # 表名前缀根据你的项目调整 table-prefix: t_ # 逻辑删除配置 logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0如果你使用 Spring Data JPAspring: jpa: # Hibernate 6.x内置的官方达梦方言 database-platform: org.hibernate.dialect.DmDialect hibernate: # 生产环境必须设置为none禁止自动建表 ddl-auto: none show-sql: true properties: hibernate: format_sql: true # 关键配置禁用JDBC4.3的一些特性避免方法未实现错误 jdbc: batch_versioned_data: false use_get_generated_keys: true batch_size: 50 # 关闭达梦不支持的特性 query: fail_on_pagination_over_collection_fetch: false⚠️ 重大避坑网上很多教程让你引入hibernate-dm-dialect第三方方言包这是完全错误的Hibernate 6.x 已经内置了官方的DmDialect引入第三方方言包会导致严重的冲突出现各种奇怪的列类型错误。第四步解决核心的列类型映射问题这是解决无效的列类型: 1111和无效的列类型: -101的关键步骤。达梦数据库的 JDBC 类型编码与 MySQL 不同特别是以下几种类型达梦数据类型MySQL 对应类型Oracle 对应类型JDBC 类型编码问题描述VARCHAR2VARCHARVARCHAR212最大长度 4000CHARCHARCHAR1无问题DATEDATETIMEDATE93达梦 DATE 包含时间MySQL DATE 不包含TIMESTAMPTIMESTAMPTIMESTAMP93无问题CLOBTEXTCLOB2005最容易出现 无效的列类型: 2005BLOBBLOBBLOB2004读取写入都容易出错NUMBERINT/BIGINTNUMBER2达梦 NUMBER 默认精度很高NUMBER(1)TINYINTNUMBER(1)2用于表示布尔值解决方案 1MyBatis-Plus 全局类型处理器创建两个全局类型处理器统一处理达梦的 CLOB 和 BLOB 类型import org.apache.ibatis.type.BaseTypeHandler; import org.apache.ibatis.type.JdbcType; import org.springframework.stereotype.Component; import java.sql.*; /** * 达梦数据库CLOB类型处理器 * 解决无效的列类型: 2005 */ Component public class DmClobTypeHandler extends BaseTypeHandlerString { Override public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException { // 直接使用setString达梦驱动会自动处理CLOB类型 ps.setString(i, parameter); } Override public String getNullableResult(ResultSet rs, String columnName) throws SQLException { return rs.getString(columnName); } Override public String getNullableResult(ResultSet rs, int columnIndex) throws SQLException { return rs.getString(columnIndex); } Override public String getNullableResult(CallableStatement cs, int columnIndex) throws SQLException { return cs.getString(columnIndex); } }import org.apache.ibatis.type.BaseTypeHandler; import org.apache.ibatis.type.JdbcType; import org.springframework.stereotype.Component; import java.sql.*; import javax.sql.rowset.serial.SerialBlob; /** * 达梦数据库BLOB类型处理器 * 解决无效的列类型: 2004 */ Component public class DmBlobTypeHandler extends BaseTypeHandlerbyte[] { Override public void setNonNullParameter(PreparedStatement ps, int i, byte[] parameter, JdbcType jdbcType) throws SQLException { Blob blob new SerialBlob(parameter); ps.setBlob(i, blob); } Override public byte[] getNullableResult(ResultSet rs, String columnName) throws SQLException { Blob blob rs.getBlob(columnName); if (blob null) { return null; } return blob.getBytes(1, (int) blob.length()); } Override public byte[] getNullableResult(ResultSet rs, int columnIndex) throws SQLException { Blob blob rs.getBlob(columnIndex); if (blob null) { return null; } return blob.getBytes(1, (int) blob.length()); } Override public byte[] getNullableResult(CallableStatement cs, int columnIndex) throws SQLException { Blob blob cs.getBlob(columnIndex); if (blob null) { return null; } return blob.getBytes(1, (int) blob.length()); } }然后在 application.yml 中注册mybatis-plus: type-handlers-package: com.yourcompany.project.handler解决方案 2JPA 实体类字段注解对于 JPA需要在实体类字段上添加正确的注解import jakarta.persistence.*; import java.time.LocalDateTime; Entity Table(name t_user) public class User { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; // 达梦VARCHAR2类型最大长度4000 Column(name username, length 50) private String username; // 达梦DATE/TIMESTAMP类型推荐使用LocalDateTime Column(name create_time) private LocalDateTime createTime; // 达梦CLOB类型用于存储大文本 Lob Column(name content, columnDefinition CLOB) private String content; // 达梦BLOB类型用于存储二进制数据 Lob Column(name avatar, columnDefinition BLOB) private byte[] avatar; // 达梦NUMBER类型对应Java的Integer Column(name age) private Integer age; // 达梦NUMBER(1)类型对应Java的Boolean Column(name status) private Boolean status; }第五步特殊字段和功能适配日期类型问题达梦的DATE类型实际上包含了时间信息而 Java 的java.sql.Date只包含日期这会导致时间丢失。最佳解决方案统一使用java.time.LocalDateTime不需要添加任何额外注解SpringBoot3 会自动处理。布尔类型问题达梦没有原生的布尔类型使用NUMBER(1)来表示布尔值。MyBatis-Plus 和 JPA 会自动处理这种映射不需要额外配置。MyBatis-Plus 分页插件适配很多人使用 MyBatis-Plus 的分页插件时会遇到分页查询总数错误的问题需要配置达梦专属的分页方言import com.baomidou.mybatisplus.annotation.DbType; import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor; import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; /** * MyBatis-Plus配置类 */ Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); // 配置达梦分页方言 interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.DM)); return interceptor; } } 常见错误对照表速查错误信息根本原因解决方案无效的列类型: 1111字段值为 null达梦驱动无法识别配置全局类型处理器实体类使用包装类型无效的列类型: -101日期类型映射错误使用 LocalDateTime 代替 java.sql.Date无效的列类型: 2005CLOB 类型映射错误使用 DmClobTypeHandler 处理器无效的列类型: 2004BLOB 类型映射错误使用 DmBlobTypeHandler 处理器getObject() not implemented驱动版本太低升级到 8.1.3.100 及以上版本登录失败用户名密码错误或端口错误检查 5236 端口和 SYSDBA 密码网络通信异常防火墙未开放 5236 端口开放服务器 5236 端口could not execute query方言配置错误配置正确的 DmDialect 方言日期差 8 小时时区配置错误连接 URL 添加 serverTimezoneAsia/Shanghai批量操作失败不支持多语句连接 URL 添加 allowMultiQueriestrue批量插入性能差未开启批量重写连接 URL 添加 rewriteBatchedStatementstrue分页查询总数错误分页方言配置错误配置 MyBatis-Plus 的 DM 分页方言⚠️ 生产环境必看避坑要点驱动版本必须匹配SpringBoot3 必须使用 8.1.3.100 及以上版本的 DmJdbcDriver18.jar这是硬性要求。不要使用第三方方言Hibernate 6.x 已经内置了官方的达梦方言引入第三方会导致严重冲突。必须配置 connection-test-queryHikariCP 默认的验证查询不适用于达梦必须设置为SELECT 1 FROM DUAL。避免使用基本类型实体类字段使用包装类型Long、Integer、Boolean避免 null 值导致的列类型错误。CLOB 字段不要超过 4000 字符达梦的 VARCHAR2 最大长度是 4000超过必须使用 CLOB 类型。关闭 SSL 连接达梦默认不开启 SSL连接 URL 中必须添加useSSLfalse。时区问题连接 URL 中必须添加serverTimezoneAsia/Shanghai否则日期会差 8 小时。禁止自动建表生产环境必须将hibernate.ddl-auto设置为none手动执行建表脚本。连接池大小不要太大达梦数据库默认最大连接数是 100连接池最大连接数不要超过 50。开启批量操作连接 URL 中添加allowMultiQueriestrue和rewriteBatchedStatementstrue否则批量操作会失败且性能极差。大小写敏感问题达梦数据库默认是大小写不敏感的如果需要大小写敏感需要在创建数据库时指定CASE_SENSITIVEY。字符集问题创建数据库时必须指定字符集为UTF-8否则会出现中文乱码问题。事务隔离级别达梦默认的事务隔离级别是读已提交与 MySQL 一致不需要额外配置。 完整可复制的生产环境配置文件这是我生产环境正在使用的完整配置直接复制修改数据库地址和密码即可spring: # 数据源配置 datasource: driver-class-name: dm.jdbc.driver.DmDriver url: jdbc:dm://192.168.1.100:5236/PROD_DB?useUnicodetruecharacterEncodingutf-8useSSLfalseserverTimezoneAsia/ShanghaiallowMultiQueriestruerewriteBatchedStatementstrue username: SYSDBA password: YourStrongPassword123! type: com.zaxxer.hikari.HikariDataSource hikari: minimum-idle: 10 maximum-pool-size: 50 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000 connection-test-query: SELECT 1 FROM DUAL auto-commit: false pool-name: DmHikariPool leak-detection-threshold: 0 # JPA配置 jpa: database-platform: org.hibernate.dialect.DmDialect hibernate: ddl-auto: none show-sql: false properties: hibernate: format_sql: false jdbc: batch_size: 50 batch_versioned_data: false use_get_generated_keys: true query: fail_on_pagination_over_collection_fetch: false # MyBatis-Plus配置 mybatis-plus: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.yourcompany.project.entity type-handlers-package: com.yourcompany.project.handler configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.nologging.NoLoggingImpl global-config: db-config: id-type: auto table-prefix: t_ logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 # 日志配置 logging: level: root: info com.yourcompany.project: debug # 关闭达梦驱动的冗余日志 dm.jdbc.driver: error 总结与专栏推荐SpringBoot3 达梦 DM9 的适配问题本质上是JDBC 规范版本不兼容和数据库类型映射差异导致的。只要按照本文的步骤使用正确版本的官方驱动配置经过生产验证的连接池参数启用 Hibernate 内置的官方方言添加全局 CLOB 和 BLOB 类型处理器正确处理特殊字段和分页功能就能解决 99% 的驱动适配和列类型错误。我把自己在信创项目中踩过的所有坑都整理成了专栏包含人大金仓 V9、达梦 DM9、PostgreSQL 等国产数据库与 SpringBoot3 的完整适配方案以及从 MySQL/Oracle 迁移的详细步骤和性能优化技巧。我的 CSDN 专栏《SpringBoot3 国产数据库适配实战》已经更新了 30 篇实战文章后续还会继续更新。觉得有用的话点赞收藏关注三连这是我持续更新的动力。有任何达梦开发或迁移问题评论区留言我会一一回复。政务选金仓金融选达梦MySQL 迁移选金仓Oracle 迁移选达梦 专注 SpringBoot3 人大金仓 达梦信创实战关注不迷路
