简介这份资源是面向使用 JetBrains DataGrip 进行多数据库开发的工程师整理的离线驱动包集合重点解决 Oracle、MySQL、MongoDB、PostgreSQL、SQL Server 等数据库在无外网或驱动下载受限环境下无法正常连接的问题。包内共 121 个文件以 27 个 jar 驱动包、22 个 pom 依赖描述、22 个 repositories 仓库配置及 42 个 sha1 校验文件为主另含少量 txt 说明与 xml 配置整体约 90.07MB覆盖 ojdbc、mysql-connector-java、mongo-jdbc-standalone 等常用驱动版本。使用时解压覆盖 DataGrip 配置目录下的 jdbc-drivers 文件夹并重启即可生效省去逐个手动下载与版本匹配的麻烦。目前已有 1117 人学习下载适合需要快速搭建本地数据库连接环境、排查驱动缺失问题的开发者参考使用。1. 驱动包这件小事为什么总在关键时刻卡住你DataGrip 装好了数据库地址、端口、账号密码全填对了点下 Test Connection 却弹出一行红字——这种场景做过数据开发的人多少都遇到过。问题往往不在网络也不在权限而是那个被忽略的驱动包Oracle 的 ojdbc、MySQL 的 mysql-connector-java、MongoDB 的 mongodb-driver-sync版本对不上、jar 缺失、依赖冲突任何一个环节都能让连接测试直接翻车。DataGrip 连接 Oracle、MongoDB、MySQL 等常用数据库时驱动包集合的管理就是这条链路上最容易被低估的一环。这篇笔记面向的是需要在本机或内网环境里稳定连上多种数据库的开发者从驱动选型、手动配置到版本冲突排查把这条路径完整走一遍让你下次遇到驱动报错时知道该翻哪本后悔药。2. 先搞清楚 DataGrip 到底怎么找驱动三种加载路径与选型逻辑DataGrip 本身不内置所有数据库的驱动 jar它依赖一套「驱动定义 本地/远程 jar」的机制。理解这套机制比死记某个 jar 名字有用得多因为不同网络环境下你需要走的加载路径完全不同。2.1 驱动定义、驱动文件与数据源的三层关系在 DataGrip 的体系里一个数据库连接由三层构成。最上层是 Data Source也就是你填主机、端口、库名、账号的那份配置中间层是 Driver它定义了「用哪个 Java 类去连、走什么 URL 模板、需要哪些 jar」最底层才是实际的 jar 文件可能躺在本地磁盘也可能由 IDE 自动下载到缓存目录。很多人连接失败时反复改 Data Source 里的参数其实问题出在中间层——Driver 指向的 jar 根本不存在或者存在但版本和数据库服务端不匹配。判断方法很直接在 DataGrip 的 Database 工具窗里打开 Data Source Properties切到 Driver 页签看下方列出的 jar 文件路径是否存在、是否有红色警告。如果路径是灰的或者标红说明驱动文件这一层就没立住改再多连接参数都是白费。三层关系里还有一个容易忽略的点同一个 Driver 可以被多个 Data Source 复用。比如你建了三个 MySQL 数据源分别连开发、测试、预发库它们其实共用同一个 Driver 定义和同一批 jar。这意味着你升级一次驱动版本三个数据源同时生效。好处是省事风险是一旦新版本有兼容问题三个环境一起挂。所以生产环境用的数据源我一般会单独复制一份 Driver 定义锁死版本不和开发环境混用。2.2 自动下载、本地 jar、Maven 坐标该选哪条路DataGrip 提供三种驱动获取方式选哪种取决于你的网络环境和合规要求。自动下载是最省事的。新建数据源时选择数据库类型DataGrip 会尝试从配置的仓库拉取推荐版本的驱动。这种方式适合能直连公网的开发机优点是版本由 IDE 帮你匹配缺点是下载源偶尔抽风或者拉到的版本和你服务端差太多。本地 jar 是内网环境的标准做法。你提前把 ojdbc、mysql-connector-java 这些 jar 下载好放到某个目录然后在 Driver 配置里点加号选「Custom JARs」逐个添加。这种方式完全可控版本、来源都清楚适合对依赖来源有审计要求的团队。Maven 坐标方式介于两者之间。你在 Driver 配置里填 groupId、artifactId、versionDataGrip 通过 Maven 仓库解析并下载。它比纯自动下载更精确因为版本是你指定的又比手动管 jar 省事因为依赖传递由 Maven 处理。缺点是仍然需要能访问 Maven 仓库纯离线环境用不了。加载方式适用环境版本可控性依赖传递离线可用自动下载可访问公网低自动否本地 jar内网/审计环境高手动是Maven 坐标可访问 Maven 仓库中高自动否选型上我的习惯是开发机用自动下载图快一旦某个库连不上就切本地 jar 排查内网和 CI 环境一律本地 jar把 jar 目录纳入版本管理谁改了驱动能追溯。2.3 各数据库驱动的核心差异与版本匹配原则Oracle、MySQL、MongoDB 这三类库的驱动差异很大不能套用同一套思路。Oracle 的 ojdbc 驱动版本和服务端版本强相关。ojdbc8 对应 JDK 8 及以上ojdbc11 对应 JDK 11 及以上而服务端是 11g、12c、19c 还是 21c对驱动的最低版本有要求。用太老的驱动连新服务端常见报错是 ORA-28040认证协议不匹配用太新的驱动连很老的服务端可能遇到字符集或时区问题。稳妥做法是驱动版本不低于服务端大版本对应的推荐版本。MySQL 这边mysql-connector-java 8.x 和 5.x 的差异主要在认证插件和时区处理。8.x 默认用 caching_sha2_password如果服务端还是老版本用 mysql_native_password连接时会报认证失败。另外 8.x 对 serverTimezone 参数更敏感不显式指定时区经常报时区错误。MongoDB 的驱动则是另一套逻辑mongodb-driver-sync 是同步驱动mongodb-driver-legacy 是老接口新项目基本都用 sync 或 reactive。MongoDB 驱动版本和服务端版本的兼容矩阵比较宽松但涉及 SCRAM 认证和 TLS 时版本太老会缺特性。提示判断驱动版本是否匹配最直接的办法是看报错信息里的关键词。ORA- 开头查 Oracle 版本兼容Communications link failure 多半是网络或驱动类加载问题Authentication failed 则优先查认证插件和密码加密方式。3. 手动配置三类驱动从下载 jar 到 Test Connection 通过这一章是实操主体。假设你在一台不能直连公网的开发机上需要手动把 Oracle、MySQL、MongoDB 三类驱动配好。下面按「准备 jar → 配置 Driver → 建 Data Source → 验证」的流程走每类库给出具体参数。3.1 准备驱动 jar目录结构与命名规范先把 jar 集中放一个目录比如~/db-drivers/按数据库分子目录避免不同库的 jar 混在一起导致类冲突。# 建立驱动目录结构按数据库类型隔离 mkdir -p ~/db-drivers/{oracle,mysql,mongodb} # 假设你已经通过合规渠道获取了以下 jar放入对应目录 # oracle/ - ojdbc8.jar或 ojdbc11.jar # mysql/ - mysql-connector-java-8.0.33.jar # mongodb/ - mongodb-driver-sync-4.11.1.jar # bson-4.11.1.jar # mongodb-driver-core-4.11.1.jar # 确认文件就位 ls -lh ~/db-drivers/oracle ~/db-drivers/mysql ~/db-drivers/mongodb这里的关键点是 MongoDB 驱动不是单个 jar。mongodb-driver-sync 依赖 bson 和 mongodb-driver-core三个 jar 必须版本一致缺一个就会在连接时抛 NoClassDefFoundError。Oracle 和 MySQL 通常是单 jar但 Oracle 某些版本会附带 orai18n.jar 处理字符集如果遇到中文乱码可以补上。命名上建议保留原始版本号不要重命名成 driver.jar 这种。因为排查问题时第一件事就是确认版本文件名带版本号能省很多事。3.2 在 DataGrip 里新建 Driver 定义并绑定本地 jar打开 DataGrip进入 Database 工具窗点加号选 Driver或者从已有数据源的 Driver 页签里复制一份再改。以 MySQL 为例步骤 1Database 工具窗 - 加号 - Driver 步骤 2Name 填 MySQL-Local-8.0.33自定义带版本便于区分 步骤 3Driver Files 区域点加号 - Custom JARs - 选中 ~/db-drivers/mysql/mysql-connector-java-8.0.33.jar 步骤 4Class 填 com.mysql.cj.jdbc.Driver 步骤 5URL template 填 jdbc:mysql://{host}:{port}/{database}Class 这一栏是重点。MySQL 8.x 的驱动类是com.mysql.cj.jdbc.Driver5.x 是com.mysql.jdbc.Driver填错会报 ClassNotFoundException。Oracle 对应oracle.jdbc.OracleDriverMongoDB 在 DataGrip 里走的是专用连接器Class 一般不用手填选对数据库类型后 IDE 会自动识别。URL template 里的{host}、{port}、{database}是占位符建 Data Source 时会替换成实际值。如果你经常连同一个库的不同实例把 template 配好能少填很多重复字段。3.3 建 Data Source 并跑通 Test Connection三类库的参数清单Driver 配好后新建 Data Source选你刚建的 Driver填连接参数。下面按三类库分别给参数。MySQL 数据源Host: 10.0.0.21 Port: 3306 Database: app_db User: app_reader Password: ****** URL 附加参数: ?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8serverTimezone 必须显式指定否则 8.x 驱动经常报The server time zone value xxx is unrecognized。useSSL 在内网可以关公网环境建议开并配证书。Oracle 数据源Host: 10.0.0.31 Port: 1521 SID 或 Service Name: ORCLPDB1Service Name 模式更常用 User: app_user Password: ****** URL 形式: jdbc:oracle:thin://10.0.0.31:1521/ORCLPDB1Oracle 的 URL 有两种写法SID 用冒号:host:port:SIDService Name 用斜杠://host:port/SERVICE。连错形式会报 ORA-12505 或 ORA-12514看报错里提的是 SID 还是 Service 就能判断。MongoDB 数据源Host: 10.0.0.41 Port: 27017 Database: app_db Auth Database: admin认证库不填默认用目标库 User: app_user Password: ******MongoDB 的认证库和业务库经常不是同一个。用户建在 admin 库但业务数据在 app_db这时 Auth Database 必须填 admin否则报 Authentication failed。这是 MongoDB 连接里最高频的坑之一。三类都填完后点 Test Connection。通过就保存不通过看下一章的排查清单。4. 驱动连不上时的排查顺序从报错定位到具体动作连接失败时最忌讳乱改参数。按固定顺序排查能大幅缩短定位时间。这一章给出一套可复用的排查流程和常见报错对照。4.1 先看 Driver 层再看 Data Source 层排查第一步永远是确认 Driver 层是否健康。打开 Data Source Properties 的 Driver 页签检查三件事jar 路径是否存在、Class 名是否正确、有没有红色警告。如果 Driver 层就有问题Data Source 层怎么改都没用。确认 Driver 层没问题后再逐项核对 Data Source 的 host、port、库名、账号。这里有个实用技巧把 URL 完整拼出来用命令行工具先测一遍排除 DataGrip 本身的干扰。比如 MySQL 可以用 mysql 客户端Oracle 可以用 sqlplusMongoDB 可以用 mongosh。命令行能通而 DataGrip 不通问题就在驱动配置命令行也不通问题在网络或服务端。4.2 常见报错与对应动作对照表报错关键词可能原因对应动作ClassNotFoundExceptionClass 名填错或 jar 未加载核对驱动类全名确认 jar 在 Driver Files 列表里NoClassDefFoundError依赖 jar 缺失MongoDB 补 bson 和 coreOracle 补 orai18nCommunications link failure网络不通或端口错telnet 测端口检查防火墙ORA-28040Oracle 驱动版本过低换 ojdbc8 或 ojdbc11Authentication failed认证库/插件不匹配MongoDB 查 Auth DatabaseMySQL 查认证插件时区 unrecognizedserverTimezone 未指定URL 加 serverTimezone 参数ORA-12505/12514Oracle URL 形式错SID 与 Service Name 写法切换这张表覆盖了八成以上的连接失败场景。遇到表里没有的报错把完整报错信息里的错误码和关键词提取出来优先搜错误码比搜整句话有效。4.3 用日志和堆栈定位驱动加载问题DataGrip 的 Test Connection 失败时弹窗里通常只有一行摘要。完整堆栈在 Help 菜单的 Show Log in Explorer 对应的日志文件里。打开日志搜SQLException或Caused by能看到驱动加载到哪一步断的。如果日志里出现java.lang.NoSuchMethodError基本可以判定是 jar 版本冲突——同一个类被两个不同版本的 jar 提供了。这种情况在同时装了多个数据库驱动、且它们依赖了同一个公共库的不同版本时会出现。解决办法是检查 Driver Files 列表把重复或冲突的 jar 移除只保留必要的那几个。5. 避坑与常见问题驱动管理里那些反复踩的坑这一章记录几个高频踩坑场景每条按现象、原因、解决来写。这些都是实际配置过程中反复出现的不是理论推演。5.1 坑一MongoDB 只加了一个 jar连接时报 NoClassDefFoundError现象Driver 配好Test Connection 直接抛java.lang.NoClassDefFoundError: com/mongodb/bson/...。原因mongodb-driver-sync 不是独立可用的它依赖 bson 和 mongodb-driver-core。只加 sync 一个 jar运行时找不到 bson 包里的类。解决把 bson、mongodb-driver-core、mongodb-driver-sync 三个 jar 全部加入 Driver Files且版本号必须一致。版本不一致会引发更隐蔽的 NoSuchMethodError。5.2 坑二MySQL 8 驱动连 5.7 服务端报认证插件错误现象报错提到caching_sha2_password或Unable to load authentication plugin。原因MySQL 8.x 驱动默认优先用 caching_sha2_password 认证而 5.7 服务端默认是 mysql_native_password两者对不上。解决两个方向。一是服务端侧把用户认证插件改成 mysql_native_password二是连接 URL 加allowPublicKeyRetrievaltrueuseSSLfalse让驱动回退到兼容模式。生产环境改服务端要谨慎优先在连接参数上解决。5.3 坑三Oracle 用 SID 写法连 Service Name 模式的库现象报 ORA-12505提示 SID 无法解析。原因服务端监听的是 Service Name而 URL 用了 SID 的冒号写法两者不匹配。解决把 URL 从jdbc:oracle:thin:host:port:SID改成jdbc:oracle:thin://host:port/SERVICE_NAME。不确定服务端是哪种模式可以问 DBA 或看监听配置里的 SERVICE_NAME 项。5.4 坑四驱动 jar 放进目录了但 DataGrip 没加载现象jar 明明在磁盘上Driver Files 列表里也加了但连接还是报 ClassNotFound。原因加 jar 时选错了文件或者加的是目录而不是具体 jar 文件。DataGrip 的 Custom JARs 需要选中具体的 .jar 文件选目录不会自动扫描。解决重新点加号定位到具体 jar 文件确认列表里显示的是完整文件名而不是目录名。加完后可以点列表里的 jar 看路径是否正确。5.5 坑五多个数据库驱动共用依赖导致版本冲突现象单独连 MySQL 正常单独连 MongoDB 也正常但两个数据源同时打开时其中一个报 NoSuchMethodError。原因两个驱动依赖了同一个公共库的不同版本DataGrip 的类加载器加载了其中一个版本另一个驱动调用时方法签名对不上。解决把不同数据库的驱动 jar 放在不同目录在各自的 Driver 定义里只引用自己目录下的 jar避免交叉。如果冲突无法避免优先升级版本较老的那个驱动让两者依赖的公共库版本对齐。6. 把驱动管理变成可复用资产版本锁定与批量迁移技巧配好一次驱动不算完真正省事的是把这套配置变成可复用、可迁移的资产。DataGrip 的配置存在项目目录或用户配置目录里换机器、换项目时如果每次重配时间都花在重复劳动上。一个实用做法是把驱动 jar 目录和 DataGrip 的驱动定义一起纳入版本管理。DataGrip 的数据源配置可以导出为 XML里面包含 Driver 定义和 Data Source 配置。导出路径在 File 菜单的 Export Settings或者直接找配置目录下的jdbc-drivers.xml和dataSources.xml。把这两个文件和~/db-drivers/目录一起提交到内部仓库新机器上导入配置、改一下 jar 路径就能用。版本锁定上我的习惯是在驱动目录里放一个VERSIONS.md记录每个 jar 的版本、来源、适配的服务端版本范围。比如# 驱动版本记录 ## Oracle - ojdbc8.jar | 版本 19.x | 适配服务端 11g/12c/19c | 来源内部制品库 ## MySQL - mysql-connector-java-8.0.33.jar | 适配服务端 5.7/8.0 | 来源内部制品库 ## MongoDB - mongodb-driver-sync-4.11.1.jar - bson-4.11.1.jar - mongodb-driver-core-4.11.1.jar 三者版本必须一致 | 适配服务端 4.4/5.0/6.0 | 来源内部制品库这份记录的价值在半年后体现。当你需要升级某个库的服务端版本时翻这份记录就知道驱动要不要跟着换不用重新试一遍。批量迁移时还有一个技巧DataGrip 支持在 Driver 定义里用相对路径引用 jar。如果你把驱动目录放在项目根目录下配置里用$PROJECT_DIR$/db-drivers/...这样的变量那么整个项目连同驱动一起拷贝到另一台机器路径不用改就能直接用。这个技巧在团队共享开发环境时特别省事新人拉下项目、导入配置驱动就齐了。最后一个习惯每次升级驱动前先在测试数据源上验证通过后再改生产数据源的 Driver 引用。因为 Driver 是复用的改一处影响一片先验证再推广能避免批量翻车。这套流程跑顺之后DataGrip 连接 Oracle、MongoDB、MySQL 的驱动管理就从每次踩坑变成一次配好、长期复用。希望帮到你。本文还有配套的精品资源点击获取