Community版必须安装Database Navigator插件才能连接MySQL,因其默认不支持数据库功能;安装后需重启IDEA,配置MySQL 8.0+对应驱动mysql-connector-j-8.3.0.jar及正确URL(含serverTimezone=UTC等参数),并确保指定Default Schema和权限。

Community版必须装Database Navigator才能连MySQL
IntelliJ IDEA Community(社区版)默认不带数据库功能,Database Tools and SQL 插件在Community版中不可用。如果你点 View > Tool Windows > Database 发现菜单灰掉、或右下角没数据库图标,不是配置错,是根本没这个能力——必须靠 Database Navigator 补上。
注意:别装错名字。搜索时认准插件名就是 Database Navigator,作者显示为 RedNixon(历史维护者)或 JetBrains 官方标识。有叫 “Database Browser”“DB Navigator” 的仿冒插件,功能残缺且不更新,容易连不上 MySQL 8.0+。
- 安装路径:按
Ctrl+Alt+S(Mac 是Cmd+,)→Plugins→Marketplace→ 搜Database Navigator - 装完必须重启 IDEA,否则
DB Browser标签不会出现在左侧工具栏 - 重启后若仍不见图标,手动打开:菜单
View > Tool Windows > Database Navigator
MySQL连接失败?大概率是驱动没配对
点 + → 选 MySQL → 填 host/port/db name/user/pass 后点击 Test Connection 报错 Cannot load JDBC driver class 'com.mysql.jdbc.Driver' 或 Unknown system variable 'query_cache_size',基本等于驱动版本和 MySQL 版本没对上。
MySQL 5.7 及以下用 mysql-connector-java-5.1.49.jar;MySQL 8.0+ 必须用 mysql-connector-j-8.3.0.jar(注意包名从 mysql-connector-java 改成了 mysql-connector-j,类名也变成 com.mysql.cj.jdbc.Driver)。
- 驱动下载地址:https://downloads.mysql.com/archives/c-j/(选 8.3.x 最新版)
- 添加方式:在连接配置窗口点
Driver Files→+→ 选中下载解压后的mysql-connector-j-8.3.0.jar - 确认 Driver Class 填的是
com.mysql.cj.jdbc.Driver,不是旧的com.mysql.jdbc.Driver - URL 示例应为
jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC,末尾参数不能少
连接成功但看不到表?检查内省权限和 schema 设置
连接状态显示 Connected,树里只有一层空节点,或者展开后只有 information_schema,说明没读到你的业务库表——常见于权限不足或 schema 未显式指定。
Database Navigator 默认只内省当前用户默认 schema(即登录时指定的 database),如果连接 URL 里没写库名,或用户没权限访问对应库,就啥都看不到。
- 确保连接 URL 包含具体库名:
jdbc:mysql://localhost:3306/your_db_name?... - 检查 MySQL 用户是否被授予该库的
SELECT权限:SHOW GRANTS FOR 'your_user'@'localhost'; - 连接后右键数据源 →
Properties→ 确认Default Schema填的是你目标库名(如your_db_name) - 右键数据源 →
Refresh(或按F5),强制重新加载元数据
配置想团队共享?别硬塞密码到 XML 里
多人协作项目里,把 database-navigator.xml 提交到 Git 很危险,尤其当文件里明文写了 password。IDEA 不会帮你加密,别人拉代码就直接拿到 DB 密码。
安全做法是用环境变量占位,让每个开发者本地配置自己的值:
- 在
.idea/database-navigator.xml中写:<property name="password" value="${DB_PASSWORD}"></property> - 在 IDEA 的
Help > Edit Custom VM Options或项目根目录加.env(需配合其他插件支持),更稳妥的是用系统级环境变量:export DB_PASSWORD=xxx - 驱动 JAR 文件不要放进项目目录,统一放在 IDEA 配置目录下(如
~/Library/Caches/JetBrains/IdeaIC2024.2/plugins/DatabaseNavigator/lib/),避免重复拷贝和提交
真正麻烦的不是连上数据库,而是连上之后发现字段类型识别错、JSON 字段显示乱码、或者执行 DDL 报语法错误——这些往往卡在驱动细节和 IDEA 缓存上,别急着重装,先清 File > Invalidate Caches and Restart。


















