DataGrip 连接达梦数据库时提示“Driver not found”如何解决？

Question

DataGrip 连接达梦数据库时提示“Driver not found”，通常因未正确配置达梦官方 JDBC 驱动（如 `DmJdbcDriver18.jar`）所致。常见原因包括：① 未在 DataGrip 的 Driver 设置中手动添加达梦驱动 JAR 包；② 使用了不兼容的 JDK 版本（达梦 v8 驱动要求 JDK 8–17，不支持 JDK 21+）；③ 驱动类名填写错误（应为 `dm.jdbc.driver.DmDriver`，非 `oracle.jdbc.driver.OracleDriver` 等）；④ JAR 包权限受限或路径含中文/空格。解决步骤：打开 DataGrip → Database → + → Driver → 新建达梦驱动 → 点击 “+” 添加下载好的 `DmJdbcDriver18.jar` → 正确设置 Class Name → 应用保存；再新建 Connection，URL 格式为 `jdbc:dm://host:port`，确保用户名密码及服务名无误。建议从达梦官网下载与数据库版本严格匹配的驱动（如 DM8 对应 Driver18），并优先使用 DataGrip 2023.3+ 版本以保障兼容性。

Answer 1

```html

一、现象层：典型错误提示与表象识别

在 DataGrip 中新建达梦（DM）数据库连接时，弹出红色警告框：“Driver not found: dm.jdbc.driver.DmDriver”，或日志中出现 java.lang.ClassNotFoundException: dm.jdbc.driver.DmDriver。该提示并非网络或认证失败，而是 JDBC 驱动类在 ClassLoader 中完全不可见——这是典型的“驱动未加载”表层信号。

二、配置层：DataGrip 驱动注册机制深度解析

• DataGrip 不内置达梦驱动，需手动注册 Driver 实体（非仅添加 JAR）；
• Driver 配置包含三要素：① JAR 文件路径（必须为本地绝对路径且可读）；② Class Name（严格区分大小写与包路径）；③ 自定义 URL 模板（影响 Connection 向导自动生成逻辑）；
• 关键陷阱：若点击“Test Connection”前未点击右下角 Apply 保存 Driver 配置，更改将被静默丢弃。

三、兼容性层：JDK、驱动版本与 DataGrip 的三角约束

达梦 v8 官方明确要求：JDBC 驱动 DmJdbcDriver18.jar 仅支持 JDK 8–17（含 LTS 和非-LTS）。实测验证显示：

JDK 版本	DmJdbcDriver18.jar 加载状态	典型异常栈片段
JDK 17.0.10	✅ 成功初始化	DriverManager.registerDriver(...)
JDK 21.0.3	❌ NoClassDefFoundError: java/sql/DriverAction	因模块系统移除 legacy SQL 接口

四、路径与权限层：被忽视的底层文件系统语义

即使 JAR 存在，以下场景仍导致加载失败：

• 路径含中文字符（如 C:\达梦驱动\DmJdbcDriver18.jar）→ DataGrip 内部 URI 解析失败；
• 路径含空格或特殊符号（如 C:\Program Files\dm\...）→ JVM `-cp` 参数截断；
• Windows 下文件被杀毒软件锁定（右键属性 → “安全”选项卡检查 ACL）；
• macOS/Linux 上 JAR 文件无 read 权限（chmod +r DmJdbcDriver18.jar）。

五、驱动匹配层：版本对齐的强制性原则

达梦数据库存在严格的驱动版本契约：

1. DM7 → 必须使用 DmJdbcDriver17.jar（类名：dm.jdbc.driver.DmDriver）；
2. DM8（含 SP1/SP2/SP3）→ 必须使用 DmJdbcDriver18.jar（类名：dm.jdbc.driver.DmDriver）；
3. 混用将引发 SQLFeatureNotSupportedException 或连接后元数据查询失败；
4. 官网下载地址：达梦驱动下载中心（需注册企业账号获取最新补丁版）。

六、实操验证层：结构化排错流程图

graph TD
  A[启动 DataGrip] --> B{Driver 已注册？}
  B -->|否| C[Database → + → Driver → + → 选 JAR]
  B -->|是| D{Class Name 正确？}
  C --> D
  D -->|否| E[填入：dm.jdbc.driver.DmDriver]
  D -->|是| F{JDK 版本 ∈ [8,17]？}
  E --> F
  F -->|否| G[降级 JDK 或升级达梦至 v2024+]
  F -->|是| H[测试连接：jdbc:dm://127.0.0.1:5236]

七、高级调优层：Connection URL 的扩展参数实践

基础 URL jdbc:dm://host:port 仅满足最小连接。生产环境推荐显式声明：

jdbc:dm://192.168.10.100:5236?useUnicode=true&characterEncoding=UTF-8&socketTimeout=30000&loginTimeout=10&zeroDateTimeBehavior=convertToNull

其中 socketTimeout 可避免长事务阻塞 UI 线程，loginTimeout 防止 DNS 解析卡死——这些参数在 DataGrip 的 Driver 编辑页“Options”标签中逐项添加，而非拼接在 URL 字段内。

八、生态协同层：IDE 版本兼容性边界确认

DataGrip 2023.3 起全面重构 JDBC 驱动沙箱机制，支持：

• 多 ClassLoader 隔离（避免 DmDriver 与 Oracle/MySQL 驱动冲突）；
• 自动检测 JAR MANIFEST.MF 中的 Implementation-Version 并校验兼容性；
• 对 module-info.class 的模块化驱动提供友好提示（DmJdbcDriver18.jar 当前仍为传统 JAR）。建议升级至 DataGrip 2024.1.3+ 以获得达梦专属诊断报告。

九、监控验证层：运行时驱动加载证据链

若仍报错，开启 JVM 级调试：

1. 在 DataGrip 的 Help → Edit Custom VM Options 中追加：-Dsun.misc.URLClassPath.debug=true；
2. 重启后观察日志中是否出现：URLClassPath: addJar: file:/.../DmJdbcDriver18.jar；
3. 若无此行，则证明 JAR 未进入 ClassPath —— 此时应检查 DataGrip 设置目录下的 options/jdbc-drivers.xml 文件，确认 <driver> 节点中 jarFiles 属性值为合法绝对路径。

十、反模式警示层：高频误操作清单

错误行为	后果	正确做法
直接将 JAR 拖入 Project 视图	仅作用于项目编译，不影响 DataGrip 连接池	必须通过 Database → Driver 面板注册
复制粘贴网上旧版 Class Name（如 dm.jdbc.Driver）	类找不到（少一个 driver 包层级）	严格使用官方文档声明的 dm.jdbc.driver.DmDriver

```