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)。
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 保存数据源配置。
怎么验证是否生效
在数据源配置页面点击 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。
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