PyCharm通过加载JDBC驱动(.jar)连接数据库,自动下载常因网络拦截、版本不匹配或IDE缓存损坏失败;手动配置需从官网下载对应驱动(如mysql-connector-java-8.3.0.jar),在数据源Driver设置中添加该jar文件,并验证版本号与Test Connection可用性。

PyCharm 本身不“安装驱动”,而是加载 JDBC 驱动文件(.jar)来连接数据库;多数情况它会自动下载,但网络受限或版本不匹配时必须手动处理。
PyCharm 自动下载 JDBC 驱动失败的常见原因
自动下载功能依赖 JetBrains 官方驱动仓库,但实际中常因以下原因卡住或报错:
- 公司内网或防火墙拦截了
https://data.jsdelivr.net或 JetBrains 的驱动 CDN - PyCharm 版本较旧(如 2023.x),不支持新版 MySQL 8.0+ 或 PostgreSQL 15+ 的驱动协议
- 选择的数据库类型与实际服务不匹配(例如选了
MySQL却连的是 MariaDB,或用了PostgreSQL驱动去连 Amazon Redshift) - IDE 缓存损坏,导致“下载缺失的驱动文件”链接不显示,哪怕驱动确实没装
手动添加 JDBC 驱动(以 MySQL 为例)
这是最稳妥、可复现的操作路径,适用于所有主流数据库(PostgreSQL、Oracle、SQL Server 等只需替换对应 jar):
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 去官网下载对应驱动:
– MySQL:访问https://dev.mysql.com/downloads/connector/j/,下载最新版mysql-connector-java-8.3.0.jar(注意:不要用 5.1.x,它不支持 TLS 1.2+ 和 caching_sha2_password 认证)
– PostgreSQL:从https://jdbc.postgresql.org/download/下载postgresql-42.7.3.jar
– SQL Server:用mssql-jdbc-12.6.1.jre11.jar(来自 Microsoft 官方 Maven 仓库) - 在 PyCharm 中打开数据源配置界面(
Database Tools → 新建 → MySQL),点击右侧Driver下拉框旁的齿轮图标 →Download missing driver files旁的+号 - 选中下载好的
.jar文件(不是 zip 包,也不是 bin 目录里的其他文件),确认后 PyCharm 会将其注册进当前数据源的 classpath - 关键验证点:驱动列表里应显示已加载的版本号(如
mysql-connector-java-8.3.0),且Test Connection按钮不再灰显
为什么不能只 pip install mysql-connector-python?
PyCharm 的数据库工具是基于 Java 实现的,它调用的是 JDBC 协议,和 Python 的 mysql-connector-python 或 pymysql 完全无关。后者只影响你代码里 import mysql.connector 的运行时行为,不影响 IDE 的可视化连接功能。
换句话说:
– pip install 解决的是 Python 脚本连库的问题
– 加载 .jar 解决的是 PyCharm 自身连库的问题
两者必须分开配置,缺一不可
容易被忽略的细节
驱动加载成功 ≠ 连接成功。很多用户卡在后续步骤:
- MySQL 8.0+ 默认使用
caching_sha2_password插件,而老驱动不识别——必须升级到mysql-connector-java-8.0.23+并在 JDBC URL 后加参数:?serverTimezone=UTC&allowPublicKeyRetrieval=true&useSSL=false - PostgreSQL 若启用 SSL,需在 PyCharm 数据源设置里勾选
Use SSL,否则即使驱动正确也报Connection refused - LocalDB 或 SQLite 这类嵌入式数据库,不需要 JDBC 驱动下载——PyCharm 内置支持,直接填路径即可(如
jdbc:sqlite:/path/to/db.sqlite)


















