📝 摘要
本文是我在信创项目中踩过的达梦 DM9 所有坑的终极总结,覆盖 SpringBoot3 整合、MySQL/Oracle 迁移、生产环境运维三大核心场景。每个报错都提供可直接复制的代码 / 配置、精准根因分析、错误复现步骤和生产级避坑要点,帮你节省至少 3 天的排查时间。
政务选金仓,金融选达梦;MySQL 迁移选金仓,Oracle 迁移选达梦 专注 SpringBoot3 + 人大金仓 + 达梦信创实战,关注不迷路
前置说明:本文适用环境
- 数据库版本:达梦 DM9 9.0.2.32 及以上 (2026 年最新稳定版)
- JDK 版本:JDK8/JDK11/JDK17
- SpringBoot 版本:SpringBoot3.0.x ~ SpringBoot3.3.x
- ORM 框架:MyBatis-Plus 3.5.3+、Hibernate 6.x
- 连接池:Druid 1.2.20+、HikariCP 5.x
⚠️ 所有代码和配置都已在上述环境中经过严格测试,可直接复制使用
⚡ 十大常见报错终极速查表
| No suitable driver found | SpringBoot 启动 | 修正驱动类名 + 引入正确依赖 | ⭐⭐⭐⭐⭐ | 🔴 致命 |
| 错误号 6001 网络通信异常 | 连接数据库 | 检查端口 + 防火墙 + 服务状态 | ⭐⭐⭐⭐⭐ | 🔴 致命 |
| 无效的表或视图名 | SQL 执行 | 加双引号 + 统一大写 + 关闭大小写敏感 | ⭐⭐⭐⭐⭐ | 🟠 严重 |
| SET IDENTITY_INSERT 为 ON | 数据插入 | 改用 AUTO_INCREMENT+MyBatis-Plus 配置 | ⭐⭐⭐⭐ | 🟠 严重 |
| 语法错误在或接近 "LIMIT" | 分页查询 | 配置正确方言 + 使用标准分页语法 | ⭐⭐⭐⭐ | 🟠 严重 |
| dbType not support | Druid 连接池 | 升级 Druid + 正确配置过滤器 | ⭐⭐⭐⭐ | 🔴 致命 |
| 字符串转换出错 | 数据查询 / 插入 | 统一字符集 + 避免隐式转换 | ⭐⭐⭐ | 🟡 一般 |
| 事务锁定超时 | 并发操作 | 优化事务 + 设置合理锁超时 | ⭐⭐⭐ | 🟠 严重 |
| 用户名或密码错误 | 连接认证 | URL 编码密码 + 用单引号包裹 | ⭐⭐⭐ | 🟡 一般 |
| 连接尚未建立或已经关闭 | 长连接 / 慢查询 | 配置连接池保活 + 调整超时参数 | ⭐⭐⭐ | 🟡 一般 |
报错一:No suitable driver found 找不到驱动
错误信息
java.sql.SQLException: No suitable driver found for jdbc:dm://127.0.0.1:5237/DAMENG
错误复现步骤
根因分析
95% 的人踩这个坑都是因为DM8 和 DM9 的驱动包和类名完全不同。DM9 对驱动包进行了彻底重构,移除了com前缀,并且默认端口从 5236 改为 5237。
终极解决方案
✅ 正确依赖 (Maven)
<!– 达梦DM9官方JDBC驱动(Java8+) –>
<dependency>
<groupId>com.dameng</groupId>
<artifactId>DmJdbcDriver18</artifactId>
<version>9.0.2.32</version> <!– 2026年6月最新稳定版 –>
</dependency>
<!– Java11+使用这个 –>
<dependency>
<groupId>com.dameng</groupId>
<artifactId>DmJdbcDriver11</artifactId>
<version>9.0.2.32</version>
</dependency>
<!– Java17+使用这个 –>
<dependency>
<groupId>com.dameng</groupId>
<artifactId>DmJdbcDriver17</artifactId>
<version>9.0.2.32</version>
</dependency>
✅ 正确配置 (application.yml)
yaml
spring:
datasource:
# DM9正确驱动类名(注意:没有com前缀!这是最容易错的地方)
driver-class-name: dm.jdbc.driver.DmDriver
# DM9默认端口是5237,DM8是5236!
url: jdbc:dm://127.0.0.1:5237/DAMENG?serverTimezone=Asia/Shanghai&characterEncoding=utf-8
username: SYSDBA
password: SYSDBA
⚠️ 避坑要点
- ❌ 不要用com.dm.jdbc.driver.DmDriver,这是 DM8 的旧驱动类名
- ❌ 不要用 5236 端口,DM9 默认端口已经改为 5237
- ✅ 驱动版本必须与数据库版本严格一致,差一个小版本都可能出现诡异问题
- ✅ SpringBoot3.2 + 不需要手动指定driver-class-name,Spring 会自动识别
- ✅ 如果是 Gradle 项目,依赖写法:implementation 'com.dameng:DmJdbcDriver18:9.0.2.32'
报错二:错误号 6001 网络通信异常
错误信息
错误号: 6001
错误消息: 网络通信异常
错误复现步骤
根因分析
这是达梦最常见的连接错误,没有之一。90% 的情况都是网络问题,剩下 10% 是数据库配置问题。
终极解决方案
步骤 1:检查数据库服务状态
# Linux系统(标准安装)
systemctl status DmServiceDMSERVER.service
# 如果是自定义实例名
systemctl status DmService你的实例名.service
# 查看所有达梦服务
systemctl list-units | grep DmService
# Windows系统
services.msc → 查找DmService开头的服务
步骤 2:检查端口连通性
# 测试端口是否开放
telnet 127.0.0.1 5237
# 或使用nc(推荐,比telnet更可靠)
nc -zv 127.0.0.1 5237
# 查看端口占用情况
netstat -tulpn | grep 5237
步骤 3:开放防火墙端口
# CentOS/RHEL 7+/Rocky Linux
firewall-cmd –add-port=5237/tcp –permanent
firewall-cmd –reload
# Ubuntu/Debian
ufw allow 5237/tcp
ufw reload
# 查看已开放的端口
firewall-cmd –list-ports
步骤 4:开启远程连接
修改/data/dmdbms/data/DAMENG/dm.ini文件:
# 允许远程连接(默认就是1,一般不需要改)
ENABLE_REMOTE_CONN=1
# 最大连接数(根据服务器配置调整,建议不超过2000)
MAX_SESSIONS=1000
# 监听所有IP地址(默认就是0.0.0.0)
LISTEN_ADDRESS=0.0.0.0
修改后重启数据库服务生效:
systemctl restart DmServiceDMSERVER.service
⚠️ 避坑要点
- ✅ 优先本地用 disql 工具测试连接:./disql SYSDBA/SYSDBA@localhost:5237
- ✅ 云服务器必须同时开放安全组和操作系统防火墙
- ❌ 不要直接关闭防火墙,只开放必要端口
- ✅ 检查dm_svc.conf文件中的服务名配置是否正确
- ✅ 如果是 Docker 部署,确保端口映射正确:-p 5237:5237
报错三:无效的表或视图名
错误信息
dm.jdbc.driver.DMException: 第1行附近出现错误:
无效的表或视图名[user]
错误复现步骤
根因分析
达梦数据库默认大小写敏感,且有1300 + 个保留关键字,远多于 MySQL。当表名 / 字段名是小写或关键字时,必须用双引号包裹。
终极解决方案
方案 1:临时解决
— 错误写法
SELECT * FROM user WHERE id = 1;
— 正确写法
SELECT * FROM "user" WHERE "id" = 1;
方案 2:MyBatis-Plus 全局配置 (强烈推荐)
mybatis-plus:
configuration:
# 自动将表名和字段名用双引号包裹(3.5.3+版本)
auto-delimit-identifiers: true
# 旧版本使用这个(已废弃)
# auto-delimit-keyword: true
global-config:
db-config:
# 达梦数据库
db-type: dm
# 统一使用大写
table-underline: true
方案 3:永久解决 (关闭大小写敏感)
⚠️ 重要提醒:只能在初始化数据库时设置,已创建的数据库无法修改!
# 初始化数据库时添加参数
./dminit path=/data/db_name CASE_SENSITIVE=0 CHARSET=1
- CASE_SENSITIVE=0:关闭大小写敏感
- CHARSET=1:设置字符集为 UTF-8
⚠️ 避坑要点
- ✅ 建表时统一使用大写字母,从根源避免大小写问题
- ✅ 避免使用user、order、group、limit、offset等关键字作为表名 / 字段名
- ❌ 不要在生产环境随意修改大小写敏感参数
- ✅ 可以使用SELECT * FROM V$RESERVED_WORDS;查询所有保留关键字
- ✅ 如果必须使用关键字,一定要用双引号包裹
报错四:仅当指定列列表,且 SET IDENTITY_INSERT 为 ON 时,才能对自增列赋值
错误信息
dm.jdbc.driver.DMException: 仅当指定列列表,且SET IDENTITY_INSERT为ON时,才能对自增列赋值
错误复现步骤
根因分析
MySQL 迁移到达梦时最常见的坑。达梦的IDENTITY自增列是严格模式,不允许手动赋值;而 MySQL 的AUTO_INCREMENT是宽松模式,可以手动赋值。
终极解决方案
方案 1:改用 AUTO_INCREMENT 语法 (强烈推荐)
— 错误写法(IDENTITY)
CREATE TABLE sys_user (
id INT IDENTITY(1,1) PRIMARY KEY,
username VARCHAR(50) NOT NULL
);
— 正确写法(AUTO_INCREMENT,与MySQL完全兼容)
CREATE TABLE sys_user (
id INT AUTO_INCREMENT PRIMARY KEY,
username VARCHAR(50) NOT NULL
);
方案 2:MyBatis-Plus 配置
@Data
@TableName("sys_user")
public class SysUser {
// 必须指定IdType.AUTO,不能用IdType.INPUT
@TableId(type = IdType.AUTO)
private Long id;
private String username;
}
方案 3:批量迁移数据时临时开启
— 开启自增列手动赋值(只对当前会话有效)
SET IDENTITY_INSERT sys_user ON;
— 插入数据(必须指定列列表)
INSERT INTO sys_user (id, username) VALUES (1, 'admin');
— 关闭自增列手动赋值
SET IDENTITY_INSERT sys_user OFF;
⚠️ 避坑要点
- ✅ MySQL 迁移时,批量将所有IDENTITY改为AUTO_INCREMENT
- ✅ 使用达梦迁移工具时,勾选 "使用 auto_increment 自增列" 选项
- ❌ 不要在生产环境长期开启IDENTITY_INSERT
- ✅ 迁移完成后,记得重置自增列起始值:ALTER TABLE sys_user AUTO_INCREMENT = 100;
- ✅ 如果是 Oracle 迁移,达梦的IDENTITY与 Oracle 的GENERATED AS IDENTITY兼容
报错五:语法错误在或接近 "LIMIT"
错误信息
dm.jdbc.driver.DMException: 第1行附近出现错误:
语法错误在或接近"LIMIT"
错误复现步骤
根因分析
虽然达梦在简单查询中支持 MySQL 风格的LIMIT语法,但在复杂查询中会失效。这是因为达梦的 SQL 解析器对LIMIT的支持有限。
终极解决方案
方案 1:配置正确的方言
# JPA/Hibernate配置
spring:
jpa:
hibernate:
ddl-auto: none
properties:
hibernate:
dialect: org.hibernate.dialect.DmDialect
format_sql: true
# MyBatis-Plus配置
mybatis-plus:
global-config:
db-config:
db-type: dm
# 3.5.3+版本不需要单独设置dialect,db-type会自动识别
方案 2:使用 ANSI 标准分页语法 (强烈推荐)
— MySQL风格(仅简单查询可用)
SELECT * FROM sys_user ORDER BY id ASC LIMIT 10, 20;
— ANSI标准(复杂查询推荐,性能更优,兼容性更好)
SELECT * FROM sys_user ORDER BY id ASC OFFSET 10 ROWS FETCH NEXT 20 ROWS ONLY;
⚠️ 避坑要点
- ✅ 复杂查询优先使用OFFSET … FETCH … ONLY语法
- ✅ 确保 ORM 框架的方言配置正确
- ❌ 不要混用不同风格的分页语法
- ✅ 分页查询必须加 ORDER BY,否则结果顺序不确定
- ✅ 如果是 Oracle 迁移,达梦也支持 Oracle 的ROWNUM分页语法
报错六:dbType not support (Druid 连接池)
错误信息
com.alibaba.druid.pool.DruidDataSource: dataSource init error
java.lang.IllegalStateException: dbType not support : dm
错误复现步骤
根因分析
Druid 连接池版本过低,对达梦数据库的支持不完善。注意:Druid 1.2.20 + 版本已经原生支持达梦数据库的所有过滤器,包括 wall 过滤器!
终极解决方案
✅ 正确的 Druid 配置 (1.2.20 + 版本)
<!– 升级Druid到最新稳定版(SpringBoot3专用) –>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid-spring-boot-3-starter</artifactId>
<version>1.2.23</version>
</dependency>
spring:
datasource:
type: com.alibaba.druid.pool.DruidDataSource
driver-class-name: dm.jdbc.driver.DmDriver
url: jdbc:dm://127.0.0.1:5237/DAMENG
username: SYSDBA
password: SYSDBA
druid:
# 1.2.20+版本可以使用所有过滤器了!
filters: stat,wall,slf4j
# 连接池配置(生产环境推荐值)
initial-size: 10
min-idle: 10
max-active: 50
max-wait: 60000
# 连接有效性检查(达梦必须加FROM DUAL)
validation-query: SELECT 1 FROM DUAL
test-while-idle: true
test-on-borrow: false
test-on-return: false
# 空闲连接检测
time-between-eviction-runs-millis: 60000
min-evictable-idle-time-millis: 300000
⚠️ 避坑要点
- ✅ 升级 Druid 到 1.2.20 + 版本,这是最根本的解决方案
- ❌ 1.2.20 以下版本必须移除 wall 过滤器,否则启动失败
- ✅ 验证查询必须使用SELECT 1 FROM DUAL,不能用SELECT 1
- ✅ 如果使用 SpringBoot3,必须用druid-spring-boot-3-starter,不能用旧版的druid-spring-boot-starter
- ✅ 如果使用 HikariCP 连接池,不需要任何特殊配置,直接使用即可
报错七:字符串转换出错
错误信息
dm.jdbc.driver.DMException: 字符串转换出错
错误复现步骤
根因分析
达梦对字符集和数据类型的要求比 MySQL 严格得多。任何不匹配的情况都会抛出异常,而不是像 MySQL 那样自动转换。
终极解决方案
步骤 1:统一字符集
确保操作系统、数据库、客户端三者字符集一致,推荐使用 UTF-8。
# JDBC连接串添加字符集参数
url: jdbc:dm://127.0.0.1:5237/DAMENG?characterEncoding=utf-8&useUnicode=true
步骤 2:避免隐式类型转换
— 错误写法(隐式转换,会导致索引失效且可能报错)
SELECT * FROM sys_user WHERE id = '1';
— 正确写法
SELECT * FROM sys_user WHERE id = 1;
步骤 3:检查数据库字符集
— 查看数据库字符集(1表示UTF-8,2表示GBK)
SELECT UNICODE();
— 查看客户端字符集
SELECT SF_GET_UNICODE_FLAG();
— 查看表的字符集
SELECT TABLE_NAME, CHARSET FROM USER_TABLES WHERE TABLE_NAME = 'SYS_USER';
— 查看字段的字符集
SELECT COLUMN_NAME, DATA_TYPE, CHAR_LENGTH FROM USER_TAB_COLUMNS WHERE TABLE_NAME = 'SYS_USER';
⚠️ 避坑要点
- ✅ 初始化数据库时指定字符集为 UTF-8:./dminit CHARSET=1
- ✅ 所有字符串类型字段使用VARCHAR,不要用CHAR
- ✅ 避免在 WHERE 条件中进行类型转换
- ✅ 检查是否有中文乱码问题,如果有,在 JDBC 连接串中添加&zeroDateTimeBehavior=convertToNull
- ✅ 确保字符串长度不超过字段定义长度
报错八:事务锁定超时
错误信息
dm.jdbc.driver.DMException: 事务锁定超时
错误复现步骤
根因分析
多个事务同时操作同一行数据,引发锁竞争,且锁超时时间设置不合理。达梦数据库默认的锁超时时间是 10 秒。
终极解决方案
步骤 1:查看锁信息和阻塞会话
— 查看当前所有锁
SELECT * FROM V$LOCK;
— 查看阻塞会话(DM9正确字段名是BLOCKED)
SELECT SESS_ID, USER_NAME, SQL_TEXT, BLOCKED, CREATE_TIME FROM V$SESSIONS WHERE BLOCKED = 1;
— 查看阻塞者和被阻塞者的关系
SELECT
w.SESS_ID AS WAITING_SESS_ID,
w.USER_NAME AS WAITING_USER,
w.SQL_TEXT AS WAITING_SQL,
h.SESS_ID AS HOLDING_SESS_ID,
h.USER_NAME AS HOLDING_USER,
h.SQL_TEXT AS HOLDING_SQL
FROM V$LOCK w
JOIN V$LOCK h ON w.TABLE_ID = h.TABLE_ID AND w.ROW_ID = h.ROW_ID
WHERE w.BLOCKED = 1 AND h.BLOCKED = 0;
— 杀死阻塞会话
SP_KILL_SESSION(会话ID);
步骤 2:调整锁超时时间
— 设置当前会话事务锁超时时间(单位:毫秒)
SET TRANSACTION WAIT 3000;
— 全局设置(修改dm.ini)
LOCK_TIMEOUT=3000
步骤 3:优化事务
- 缩小事务范围,避免长事务
- 按相同顺序访问表和行
- 避免在事务中执行耗时操作 (如调用外部接口)
- 对于读多写少的场景,考虑使用乐观锁
⚠️ 避坑要点
- ✅ 锁超时时间建议设置为 3-5 秒
- ✅ 生产环境开启死锁检测:DEADLOCK_DETECT=1
- ❌ 不要将锁超时时间设置过长
- ✅ 定期监控长事务:SELECT * FROM V$TRX WHERE DATEDIFF(SECOND, START_TIME, NOW()) > 60;
- ✅ 对于批量操作,建议分批提交,避免长事务
报错九:用户名或密码错误 (密码含特殊字符)
错误信息
dm.jdbc.driver.DMException: 用户名或密码错误
错误复现步骤
根因分析
密码中包含特殊字符,导致 JDBC URL 解析异常或 YAML 配置文件解析错误。
终极解决方案
方案 1:用单引号包裹密码 (最简单)
spring:
datasource:
# 用单引号包裹含特殊字符的密码
password: 'P@ssw0rd!123&abc'
方案 2:URL 编码密码
// 对密码进行URL编码
String password = URLEncoder.encode("P@ssw0rd!123&abc", StandardCharsets.UTF_8.name());
方案 3:使用配置类 (最可靠)
@Configuration
public class DataSourceConfig {
@Bean
@ConfigurationProperties("spring.datasource.druid")
public DataSource dataSource() {
return DruidDataSourceBuilder.create().build();
}
}
⚠️ 避坑要点
- ✅ 密码尽量避免使用特殊字符
- ✅ 必须使用特殊字符时,优先使用配置类方式
- ✅ 本地用 disql 工具验证用户名密码是否正确:./disql SYSDBA/'P@ssw0rd!123'@localhost:5237
- ✅ 不要在密码中使用#字符,YAML 会将其解析为注释
- ✅ 如果使用环境变量传递密码,不需要任何特殊处理
报错十:连接尚未建立或已经关闭
错误信息
dm.jdbc.driver.DMException: 连接尚未建立或已经关闭
错误复现步骤
根因分析
连接池中的连接被数据库端主动关闭,而应用端仍在使用这些无效连接。达梦数据库默认会关闭空闲超过 8 小时的连接。
终极解决方案
✅ 连接池保活配置 (生产环境推荐)
spring:
datasource:
druid:
# 连接有效性检查
validation-query: SELECT 1 FROM DUAL
test-while-idle: true
test-on-borrow: false
test-on-return: false
# 空闲连接检测间隔(1分钟)
time-between-eviction-runs-millis: 60000
# 连接最小空闲时间(5分钟,必须小于数据库的IDLE_TIMEOUT)
min-evictable-idle-time-millis: 300000
# 连接最大存活时间(30分钟)
max-evictable-idle-time-millis: 1800000
# 移除废弃连接(防止连接泄漏)
remove-abandoned: true
remove-abandoned-timeout: 180
log-abandoned: true
✅ JDBC 连接串添加超时参数
url: jdbc:dm://127.0.0.1:5237/DAMENG?socketTimeout=60000&loginTimeout=30
✅ 调整数据库端空闲超时时间 修改dm.ini文件:
# 空闲连接超时时间(单位:秒,默认28800=8小时)
IDLE_TIMEOUT=1800
⚠️ 避坑要点
- ✅ socketTimeout必须大于最长查询预期耗时
- ✅ 连接池最大连接数不应超过数据库MAX_SESSIONS的 70%
- ✅ 生产环境必须开启remove-abandoned,防止连接泄漏
- ✅ 应用端的min-evictable-idle-time-millis必须小于数据库端的IDLE_TIMEOUT
- ✅ 配置连接池的重试机制,当获取连接失败时自动重试
🛡️ 生产环境终极避坑指南
🔄 MySQL/Oracle 迁移专项避坑
MySQL 迁移到达梦
- ✅ 批量将所有IDENTITY改为AUTO_INCREMENT
- ✅ 将TEXT类型改为CLOB或VARCHAR(4000)
- ✅ 将DATETIME类型改为TIMESTAMP
- ✅ 移除所有LIMIT语法,改用OFFSET … FETCH … ONLY
- ✅ 检查所有关键字,用双引号包裹
Oracle 迁移到达梦
- ✅ 达梦的IDENTITY与 Oracle 的GENERATED AS IDENTITY兼容
- ✅ 达梦支持 Oracle 的ROWNUM分页语法
- ✅ 达梦支持 Oracle 的大部分内置函数
- ✅ 将VARCHAR2改为VARCHAR
- ✅ 检查所有序列,达梦的序列语法与 Oracle 基本一致
📊 生产环境监控告警配置
关键监控指标
| 连接数使用率 | >80% | 🟡 警告 |
| 连接数使用率 | >90% | 🟠 严重 |
| 锁等待时间 | >1 秒 | 🟡 警告 |
| 锁等待时间 | >3 秒 | 🟠 严重 |
| 慢查询数量 | >10 个 / 分钟 | 🟡 警告 |
| 慢查询数量 | >50 个 / 分钟 | 🟠 严重 |
| 长事务数量 | >5 个 | 🟡 警告 |
| 长事务数量 | >20 个 | 🟠 严重 |
常用监控 SQL
— 查看当前连接数
SELECT COUNT(*) FROM V$SESSIONS;
— 查看慢查询
SELECT * FROM V$SQL WHERE EXEC_TIME > 1000 ORDER BY EXEC_TIME DESC;
— 查看长事务
SELECT * FROM V$TRX WHERE DATEDIFF(SECOND, START_TIME, NOW()) > 60;
— 查看锁等待
SELECT * FROM V$LOCK WHERE BLOCKED = 1;
🔧 常见问题终极 Q&A
Q1:达梦数据库如何查看版本?
SELECT * FROM V$VERSION;
Q2:达梦数据库如何查看当前用户?
SELECT USER;
Q3:达梦数据库如何查看所有表?
SELECT TABLE_NAME FROM USER_TABLES;
Q4:达梦数据库如何开启慢查询日志?
修改dm.ini文件:
SVR_LOG=1
SVR_LOG_SQL_MODE=1
SVR_LOG_SLOW=1
SVR_LOG_SLOW_TIME=1000 # 单位:毫秒
Q5:达梦数据库如何查看执行计划?
EXPLAIN SELECT * FROM sys_user WHERE id = 1;
Q6:达梦数据库如何重置自增列?
ALTER TABLE sys_user AUTO_INCREMENT = 100;
Q7:达梦数据库如何杀死会话?
SP_KILL_SESSION(会话ID);
📚 专栏推荐
- SpringBoot3 整合达梦 DM9 超详细入门实战 | 从零搭建可直接上线
- MySQL 迁移至达梦 DM9 完整改造指南 | 99% SQL 零改动
- 达梦 DM9 与人大金仓 V9 深度对比 | 信创数据库选型必看
- SpringBoot3 整合 MyBatis-Plus 3.5.5 + 达梦 DM9 完整教程
- 达梦 DM9 生产环境部署与运维指南 | 从安装到监控
专注 SpringBoot3 + 人大金仓 + 达梦信创实战,关注不迷路! 有问题评论区留言,我会一一解答。 收藏 + 点赞 + 关注,下次遇到达梦问题不迷路!



