IDEA 2023.2 如何配置数据库工具窗口连接 MySQL 8.0

文章导读
IntelliJ IDEA 2023.2 通过数据库工具窗口连接 MySQL 8.0 需使用内置 MySQL 数据源,适用于 Ultimate 版或已安装数据库插件的 Community 版。配置核心在于驱动自动下载与认证插件兼容性,默认端口为 3306。
📋 目录
  1. 快速处理思路
  2. 为什么会这样
  3. 分步处理
  4. 怎么验证是否生效
  5. 常见坑
  6. 常见问题
  7. 参考来源
A A

IntelliJ IDEA 2023.2 通过数据库工具窗口连接 MySQL 8.0 需使用内置 MySQL 数据源,适用于 Ultimate 版或已安装数据库插件的 Community 版。配置核心在于驱动自动下载与认证插件兼容性,默认端口为 3306。

先说结论:IDEA 2023.2 内置驱动支持 MySQL 8.0 默认认证协议,只需在数据库工具窗口添加 MySQL 数据源并完成驱动下载即可连接。

  • 适合:IntelliJ IDEA Ultimate 用户或安装了数据库管理插件的 Community 用户
  • 先准备:确认 MySQL 服务已启动、知晓主机 IP 与账号密码、网络可达
  • 验收:点击测试连接显示 Succeeded 且能展开表结构

快速处理思路

图形界面配置无需命令行,按以下路径操作:打开数据库工具窗口,添加 MySQL 数据源,填写连接信息,触发驱动下载,执行测试连接。

为什么会这样

连接失败通常是因为驱动版本与 MySQL 8.0 认证插件不匹配。MySQL 8.0 默认使用 caching_sha2_password 认证插件,旧版 JDBC 驱动不支持该协议,IDEA 2023.2 默认集成的 MySQL Connector/J 版本已修复此兼容性问题。

分步处理

1. 打开数据库工具窗口:点击菜单栏 View -> Tool Windows -> Database,或按快捷键 Ctrl+Shift+F12(Windows/Linux)/ Cmd+Shift+F12(macOS)。

IDEA 2023.2 如何配置数据库工具窗口连接 MySQL 8.0

2. 添加数据源:在 Database 窗口左上角点击 + 号,选择 Data Source -> MySQL。

3. 填写连接信息:在 Host 填写 MySQL 服务器 IP(本地通常为 localhost),Port 保持 3306,User 和 Password 填写对应账号密码。

4. 下载驱动:若界面提示 Missing driver files,点击 Download 按钮,IDEA 会自动从 Maven 仓库拉取匹配的 JDBC 驱动。

5. 保存配置:点击 Apply 或 OK 保存数据源配置。

IDEA 2023.2 如何配置数据库工具窗口连接 MySQL 8.0

怎么验证是否生效

在数据源配置页面点击 Test Connection 按钮,观察弹窗提示。若显示绿色 Succeeded 字样,表示连接成功。返回 Database 工具窗口,展开该数据源节点,若能列出 schemas 和 tables 列表,说明读写权限正常。

常见坑

1. 认证插件错误:若报错 Access denied,检查 MySQL 用户是否使用 caching_sha2_password,可在 MySQL 服务端执行 ALTER USER 命令兼容旧协议,或确保 IDEA 驱动为 8.x 版本。

2. 时区不一致:连接字符串可能报 Timezone 错误,在 Advanced 选项卡中设置 serverTimezone 为 Asia/Shanghai 或 UTC。

IDEA 2023.2 如何配置数据库工具窗口连接 MySQL 8.0

3. 社区版限制:IntelliJ IDEA Community Edition 原生不支持 Database 工具窗口,需安装第三方插件如 Database Navigator,否则无法看到数据库菜单。

常见问题

IDEA Community 版能直接连接 MySQL 吗

原生不支持,需安装插件。IntelliJ IDEA Community Edition 默认不包含 Database 工具窗口功能,建议安装 Database Navigator 插件或升级至 Ultimate 版。

测试连接显示 Driver not found 怎么办

点击下载按钮手动获取驱动。在数据源配置页面的 Driver 栏点击 Download 链接,确保网络能访问 Maven 中央仓库,若失败可手动下载 jar 包后通过 + 号添加。

连接 MySQL 8.0 报 SSL 警告如何处理

在高级配置中调整 SSL 模式。进入数据源配置的 Advanced 选项卡,将 useSSL 设置为 false 或 verifyServerCertificate 设置为 false,生产环境建议配置正式证书。

参考来源

  • JetBrains Official Documentation, Database Tool Window, https://www.jetbrains.com/help/idea/database-tool-window.html
  • JetBrains Official Documentation, Connect to a MySQL Database, https://www.jetbrains.com/help/idea/connecting-to-a-mysql-database.html