PyCharm连接MySQL需内置工具、JDBC驱动与数据源配置协同:先下载MySQL Connector/J 8.x驱动,再填127.0.0.1等正确参数,最后勾选All Schemas并刷新。

PyCharm 连接 MySQL 数据库,不是装个插件就完事,而是靠内置数据库工具 + JDBC 驱动 + 正确的数据源配置三者协同。多数人卡在“测试连接失败”或“连上了但看不到库”,问题基本出在这三步中的某一个环节。
点击 Test Connection 之前必须解决 driver 缺失
PyCharm 默认不自带 MySQL JDBC 驱动(mysql-connector-java),所以新建 MySQL 数据源后,界面底部一定会显示 Download missing driver files 链接——这不是提示,是强制前置步骤。
- 必须先点这个链接下载驱动,PyCharm 会自动解压并注册;手动下载
mysql-connector-java-8.0.33.jar(推荐 8.x,兼容性比 5.1.x 好)再通过+ Add加载也行,但别用太老的版本(比如mysql-connector-java-5.1.46-bin.jar),容易和新版 MySQL 8+ 的认证插件(caching_sha2_password)冲突 - 如果点了下载但没反应,检查 IDE 是否能访问外网;公司内网环境常见被拦截,此时需手动下载 jar 包,再通过数据源设置页的
Driver选项卡 →+→ 选择本地 jar 文件 - 驱动加载成功后,
Driver下拉框里应显示类似MySQL Connector/J (8.0.33),且Class自动填为com.mysql.cj.jdbc.Driver(注意是cj,不是旧版的jdbc.Driver)
Host、Port、User、Password 填对了,还连不上?查网络和权限
填写连接参数时,Host 写 localhost 或 127.0.0.1 看似没问题,但实际行为不同:MySQL 默认只允许 localhost 走 socket 连接,而 PyCharm JDBC 强制走 TCP,所以建议统一用 127.0.0.1。
-
Port默认是3306,确认 MySQL 实际监听端口:netstat -an | grep :3306(Linux/macOS)或netstat -ano | findstr :3306(Windows) -
User必须有远程访问权限。仅创建用户不够,还要执行:GRANT ALL ON *.* TO 'your_user'@'%' IDENTIFIED BY 'your_pass'; FLUSH PRIVILEGES;(@'%'表示允许任意 host 连接) - 防火墙可能拦掉
3306端口,临时关掉试试:sudo ufw disable(Ubuntu)或检查 Windows Defender 防火墙入站规则 - 云数据库(如阿里云 RDS)必须在控制台白名单里添加你的公网 IP,或设为
0.0.0.0/0(仅测试用)
连上了却只显示 information_schema,看不到自己的库?
这是 PyCharm 默认只加载当前登录用户的默认库(或空库),不是连接失败,而是 Schema 加载策略问题。
- 右键已连接的数据源 →
Properties→ 切到Options标签页 → 找到Schemas区域 → 勾选All Schemas→ 点OK - 如果勾选后仍不刷新,右键数据源 →
Refresh(或按Ctrl+F5),不是靠重启 IDE - 某些 MySQL 配置禁用了
SHOW DATABASES权限,导致 PyCharm 无法枚举库名,此时可在Options标签页的Database字段手动输入你要操作的库名(如joker),再刷新
连接成功但执行 SQL 报错:Access denied for user 或 Public Key Retrieval
这类错误往往出现在 MySQL 8.0+ 和较新驱动组合下,和密码认证方式强相关。
- 若报
Public Key Retrieval is not allowed,在数据源的URL字段末尾追加参数:?allowPublicKeyRetrieval=true&useSSL=false(生产环境应配 SSL,测试可先关) - 若报
Access denied for user ... using authentication plugin 'caching_sha2_password',说明用户认证插件不兼容旧驱动。要么升级驱动(用 8.x),要么在 MySQL 中重置用户插件:ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass'; FLUSH PRIVILEGES; - URL 字段优先级高于表单字段,如果手动写了 JDBC URL(如
jdbc:mysql://127.0.0.1:3306/joker?serverTimezone=UTC),表单里的Database和Port就会被忽略,务必保持一致
真正卡住的点,往往不在“怎么点按钮”,而在驱动版本、认证插件、网络可达性、Schema 加载策略这四个地方来回试。尤其 caching_sha2_password 和 allowPublicKeyRetrieval 这两个参数,不显式配就大概率连不上——它们不会自动推导,也不会在 UI 里提醒你缺什么。


















