IDEA连接MySQL数据库怎么配置，配置步骤有哪些？

在 IntelliJ IDEA 中配置 MySQL 连接，最直接的方式是使用内置的 Database 工具窗口，通过添加数据源并下载匹配的 JDBC 驱动即可完成，关键在于驱动版本与 MySQL 版本对应以及连接参数的正确性。

许多开发者第一次在 IDEA 中配置 MySQL 连接时，往往会卡在驱动下载失败或时区报错上，其实整个流程并不复杂，只要按顺序检查环境、填写参数、测试连接，就能顺利把数据库集成到 IDE 中，下面我会从最基础的准备开始，一步步带你走通这个配置。

加载中

使用Idea连接MySQL数据库

大家好我叫王大顺

7.7万69017

原视频地址

idea连接mysql数据库配置前的环境检查

在动手配置之前,花几分钟确认一下当前环境，能避免后面很多弯路，这一步虽然不起眼，但大多数连接失败都源于环境问题。

确认MySQL服务运行状态与版本号

首先确保 MySQL 服务已经启动，在 Windows 上可以通过任务管理器查看服务，Linux 或 Mac 下使用 systemctl status mysql 或 mysql.server status 确认，服务没跑起来，IDEA 自然连不上。

其次要知道 MySQL 版本，登录 MySQL 后执行 SELECT VERSION();，或者直接查看启动日志，版本信息直接关系到 JDBC 驱动的选择，MySQL 5.7 用 mysql-connector-java 5.x 系列，MySQL 8.0 则需要 8.x 系列，如果你的 MySQL 版本较新，尽量使用对应的大版本驱动，避免兼容性问题。

检查IDEA版本与Database插件

IntelliJ IDEA 在 Community 版和 Ultimate 版中都有 Database 工具窗口，但 Ultimate 版功能更全，支持直接编辑数据、显示 ER 图，Community 版虽然也有数据库功能，但部分高级选项需要手动启用，确保你使用的 IDEA 版本不低于 2020 年以后的版本，因为旧版本的驱动管理界面不太一样，操作起来可能找不到对应按钮。

在 IDEA 中打开 File -> Settings -> Plugins，搜索 Database，确认插件已启用，默认情况下 Database 插件是内置的，不需要额外安装，但如果被禁用会导致工具窗口无法显示。

准备JDBC驱动：自动下载还是手动配置

IDEA 在添加数据源时，会自动检测并提示下载对应的驱动，这是最省心的方式，但有时因为网络问题或防火墙阻拦，自动下载会失败，这时候就需要手动下载驱动包。

到 MySQL 官网下载 mysql-connector-java，解压后得到一个 jar 文件，在 IDEA 中配置数据源的时候，选择“手动设置驱动”，然后选择本地的 jar 路径，注意驱动版本不要比 MySQL 服务版本低太多，否则部分功能可能不兼容。

配置mysql连接的核心操作流程

环境准备就绪后,就可以进入实际的配置环节了，这一部分我尽量把每一步都写清楚，你跟着操作就能完成。

打开Database工具窗口

在 IDEA 的右侧边栏有一个 Database 标签，点击即可打开，如果没有，可以通过 View -> Tool Windows -> Database 调出，或者直接使用快捷键 Alt+8（Windows/Linux）或 Cmd+8（Mac）。

添加MySQL数据源

在 Database 窗口中点击左上角的 号，选择

Data Source -> MySQL，注意不要选成 MariaDB，虽然它们驱动类似，但连接参数有细微差别。

填写连接信息

在弹出的数据源配置对话框中,需要填写以下内容：

• Host：MySQL 服务所在的主机，本地填 localhost 或 0.0.1，远程填 IP 地址。
• Port：默认 3306，如果你改了 MySQL 端口，请填实际端口。
• Database：要连接的数据库名，如果不填，连接后可以手动选择，但建议直接填上，避免后续操作再选一次。
• User：MySQL 用户名，通常是 root，但生产环境建议使用专用账号。
• Password：对应用户的密码。

在 URL 栏会自动生成 JDBC 连接字符串，jdbc:mysql://localhost:3306/数据库名?useSSL=false&serverTimezone=UTC，这里有几个参数需要特别注意：

• useSSL=false：除非你明确需要 SSL 连接，否则建议设为 false，避免非必要的握手开销。
• serverTimezone=UTC：设置时区，如果不指定，可能会因为 MySQL 时区与系统时区不一致导致报错，你也可以填 Asia/Shanghai 或 GMT+8。

驱动设置与下载

在下方 Driver 部分，如果看到 No driver files 的提示，说明需要下载驱动，点击 Download 按钮，IDEA 会自动从网络获取，如果下载失败，换成手动方式：点击 MySQL Connector Java 旁边的下拉箭头，选择 Mysql（如果有多个版本），然后再次尝试下载，仍然不行的话，就完全手动添加：点击 号，选择 Custom JARs，选中你提前下载好的 jar 包。

测试连接

所有信息填写完毕,点击 Test Connection 按钮，如果看到绿色的 Success 提示，说明配置成功了，如果失败，错误信息会告诉你具体原因，Access denied、Communications link failure 或者 The server time zone value 等，这时不要慌，下一步就是针对这些问题的排查方法。

idea连接mysql数据库配置常见问题排查

连接测试失败是新手遇到最多的情况,但绝大多数错误都有明确的解决办法，下面列出几个高频问题及对应的解决方案，你可以对照着处理。

驱动下载失败或没有合适的驱动

自动下载时出现 Cannot download driver 的提示，通常是因为网络受限或 IDEA 的更新仓库被墙，解决办法是手动下载驱动并本地加载，如果你的 MySQL 版本比较老（5.5），而 IDEA 默认下载的驱动是 8.x，也可能不兼容，这时手动选择驱动版本：在驱动下拉列表里有一个 Mysql 项，点开可以看到多个版本，找一个与你的 MySQL 版本匹配的，MySQL 5.6 用 1.49，MySQL 5.7 用 1.48 或 0.x 都可以，但 8.0 驱动对 5.7 有更好的兼容性。

时区错误：The server time zone value is unrecognized

这个错误信息非常典型,连中文时区也会出现，根本原因是 MySQL 和 IDEA 的时区设置不一致，解决方案有两种：

• 在连接 URL 尾部添加 serverTimezone=UTC 或 serverTimezone=Asia/Shanghai。
• 在 MySQL 中执行 SET GLOBAL time_zone = '+8:00';，永久修改服务端时区。

如果不想改 URL，也可以在 IDEA 的 Advanced 选项卡中直接设置 serverTimezone 参数。

通信链接失败：Communications link failure

这个错误往往意味着 IDEA 和 MySQL 服务之间没有建立网络连接，排查步骤：

1. 确认 MySQL 服务是否正在运行：在命令行执行 mysql -u root -p 看能否登录。
2. 检查防火墙是否放行了 3306 端口：Windows 防火墙、Linux 的 iptables 或 ufw 都可能拦截。
3. 确认 MySQL 的绑定地址：MySQL 配置中 bind-address 被设为 0.0.1，那么远程连接会被拒绝，需要改为 0.0.0 或实际的 IP。
4. 检查 IDEA 中的主机地址是否写错：本地用 localhost，不要用 0.0.1 有时会出现意外的解析问题，但本质上没区别，如果用了 localhost 不行，试试 0.0.1。

Access denied for user

这个错误说明用户名或密码不正确,或者该用户没有从当前主机访问的权限，在 MySQL 中执行 SELECT user, host FROM mysql.user; 查看用户表，确认 root 用户是否有 或 localhost 的权限，如果只有 localhost，那么在 IDEA 中用 localhost 连接就没问题，但用 IP 就会报错，可以给 root 添加远程权限，或者创建一个新用户专门给 IDEA 使用。

其他常见错误：Public Key Retrieval is not allowed

MySQL 8.0 默认使用 caching_sha2_password 认证插件，如果连接时没有配置 allowPublicKeyRetrieval=true，就会出现这个错误，在 URL 中加上 allowPublicKeyRetrieval=true（注意与前面的参数用 & 连接）即可，但要注意，这个参数在非 SSL 连接下可能不安全，只在开发环境使用。

成功配置mysql连接后的操作验证

配置完成后,就可以在 IDEA 中直接操作数据库了，打开 Database 窗口，展开你的数据源，就能看到数据库列表和表结构。

浏览数据库表结构

双击某个表,IDEA 会打开一个新标签页，显示表的数据和结构，在 Schema 面板中可以看到字段名、类型、键、默认值等信息，如果觉得自动显示的表太多，可以在数据源配置中勾选 Schemas 选项卡，只选择你需要的数据库，这样窗口会更清爽。

执行SQL查询

在 Database 窗口右键点击数据源，选择 Open Console，会打开一个 SQL 编辑器，在这里你可以直接写查询语句，按 Ctrl+Enter 执行，结果会在下方显示，语法高亮和自动补全都非常好用，比用命令行或第三方工具效率高得多。

导出数据表结构或数据

IDEA 支持将表结构导出为 SQL 脚本，也可以直接导出数据为 CSV、JSON 等格式，右键点击表，选择

Export Data to File，按照向导操作即可，这在迁移数据或备份时非常方便。

配置mysql连接后的进阶调优

连接成功后,还有一些小技巧能让你的体验更顺畅，下面这几个配置虽然不是必须的，但用起来会省很多事。

配置SSH隧道连接远程数据库

如果你的数据库只能通过 SSH 访问，可以在数据源配置中切换到 SSH/SSL 选项卡，设置 SSH 跳板机的信息，IDEA 会自动建立隧道，然后通过本地端口转发连接数据库，这样你就不需要在本地装 MySQL 客户端了。

显示所有数据库

默认情况下,IDEA 只显示你指定的数据库，如果你需要看到 MySQL 实例下的所有数据库，可以在数据源 General 选项卡中，把 Database 字段留空，然后在 Schemas 选项卡中勾选 Show all databases，这样连接后就能看到所有数据库，但注意不要随意修改系统库。

使用连接池参数

在 Advanced 选项卡中，可以设置一些连接池相关的参数，maxReconnects、initialTimeout 等，IDEA 的数据库连接主要用于开发，这些参数保持默认就够了，如果你在 IDEA 中写大量脚本，可以适当调大超时时间，避免长时间空闲导致连接断开。

在 IntelliJ IDEA 中配置 MySQL 连接并不复杂，核心就是三件事：环境准备、驱动匹配、参数填写，大部分报错都集中在驱动版本和时区设置上，按照上面的排查思路，基本都能解决，配置好之后，你就能在一个 IDE 里完成前后端开发和数据库管理，大幅减少工具切换的时间。

idea连接mysql数据库配置常见问题与解答

Q1：为什么我按照步骤配置了，测试连接时还是提示“Communications link failure”？

A：这个错误通常不是 IDEA 配置问题，而是网络层面的，先检查 MySQL 服务是否启动，再检查防火墙是否拦截了 3306 端口，MySQL 装在远程服务器，确认 bind-address 没有限制为 0.0.1，本地连接的话，也可以尝试把 localhost 换成 0.0.1 或 :1。

Q2：配置mysql连接时驱动下载总失败，有没有其他办法？

A：手动下载是可靠的替代方案，到 MySQL 官网下载 mysql-connector-java 的 jar 包，选择与你的 MySQL 版本匹配的版本，然后在 IDEA 的驱动设置中选择 Custom JARs，指向你下载的 jar 文件，不需要额外配置，直接就能用。

Q3：在连接字符串中加了 useSSL=false 和 serverTimezone=UTC，但测试时仍报时区错误，怎么办？

A：如果参数写对了还是报错，检查一下是否有拼写错误，serverTimezone 写成了 serverTimezone 少个字母，在 Advanced 选项卡中也可以直接设置 serverTimezone 属性，效果一样，如果还不行，在 MySQL 中执行 SET GLOBAL time_zone = '+8:00'; 并重启连接，问题基本能解决。