IDEA如何连接MySQL数据库，连接失败怎么办？

IDEA连接MySQL数据库的完整流程并不复杂，核心在于驱动版本匹配、URL参数写法和数据库服务状态三大前提。 把这三点弄清楚，从配置数据源到代码访问，一条路走通，多数连接失败的问题都能快速定位。

连接前，先把这三个问题在脑子里过一遍

不少开发者在IDEA里折腾半天连不上数据库,其实问题不在操作，而在环境准备，动手之前，先检查三件事。

加载中

使用Idea连接MySQL数据库

大家好我叫王大顺

7.7万69017

原视频地址

第一，MySQL服务是否真的在运行。 在Windows命令行执行net start | findstr mysql，或者在macOS终端执行brew services list，能看到mysql进程说明服务正常，服务没起来，IDEA这边无论怎么配置都会报连接超时。

第二，确认MySQL版本和驱动版本要匹配。 如果你本地装的是MySQL 8.0及以上，那么驱动类名要写com.mysql.cj.jdbc.Driver，JDBC URL里的连接参数也要跟着变，如果是MySQL 5.x老版本，用com.mysql.jdbc.Driver就行，两者混用，大概率报ClassNotFoundException或Unsupported major.minor version。

第三，检查3306端口是否被占用或屏蔽。 在终端执行telnet 127.0.0.1 3306，能通说明本地端口正常，如果是远程连接，还要确认云服务器的安全组规则是否放行了3306端口，以及MySQL配置文件里的bind-address是否允许远程IP访问，业内专家指出，远程连接失败有较大比例是云厂商安全组规则没配置完整，和代码本身没半点关系。

这三项确认无误后,再进行IDEA侧的连接配置，排错时能少走很多弯路。

idea连接mysql数据库详细步骤：面板操作与参数填写

以2020.2之后的IDEA版本为例，数据库工具已经内置，不需要额外安装插件，操作路径如下：

1. 点击IDEA右侧边栏的Database面板，如果没有，点击View -> Tool Windows -> Database调出。
2. 点击面板左上角的加号，选择Data Source，再选MySQL。
3. 在弹出窗口中填写连接信息：
   • Host：localhost（本地）或远程服务器IP
   • Port：3306
   • User：root或你的业务账号
   • Password：对应密码
4. 点击Test Connection按钮，等待提示连接成功。

如果是2020.2之前的版本，需要在插件市场搜索Database Navigator插件安装后，通过View -> Tool Windows -> Database Browser打开数据源管理界面，操作逻辑基本一致，入口位置不同而已。

MySQL 8.0的URL写法差异

MySQL 8.0在连接参数上有一些细微变化，很多报错都源于此，直接在IDEA里填写可视化表单通常会自动生成正确URL，但如果手写JDBC连接串，下面这几个参数务必带上：

jdbc:mysql://localhost:3306/database_name?useSSL=false&serverTimezone=UTC&characterEncoding=utf8&allowPublicKeyRetrieval=true

• serverTimezone=UTC：解决时区报错Server returns invalid timezone。
• allowPublicKeyRetrieval=true：解决Public Key Retrieval is not allowed错误。
• useSSL=false：本地开发环境关闭SSL，避免告警日志干扰。
• characterEncoding=utf8：统一编码，防止中文乱码。

如果是MySQL 5.7版本，可以简写为：

jdbc:mysql://localhost:3306/database_name?useUnicode=true&characterEncoding=utf8

不需要serverTimezone，也不需要allowPublicKeyRetrieval，这一点记住，能省下不少排查时间。

驱动下载的两个时机

在IDEA的DataSource配置窗口里,第一次点击Test Connection时，如果本地没有对应的JDBC驱动，IDEA会提示Download missing driver files，点击下载即可，这是最简单的驱动获取方式。

另一种场景是你在Spring Boot或普通Maven项目中用代码连数据库，需要在pom.xml里显式引入驱动依赖，日常开发中用得比较多的版本写法如下：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version>
</dependency>

需要注意的是,从MySQL Connector/J 8.0.31开始，驱动坐标改成了com.mysql:mysql-connector-j，原来的mysql:mysql-connector-java坐标依然可用，但新项目建议使用新坐标，这部分版本更新迭代较快，建议参考官方发布说明进行适配，这里不逐一展开站不住脚的数据。

idea连接mysql数据库8.0报错，多半出在时区与公钥校验

把常见报错信息整理成一张排查表,遇到问题直接对照处理，比读异常堆栈更高效。

时区报错在MySQL 8.0中尤其常见，但并不复杂。serverTimezone=UTC适合utc时间操作，但如果你想直接使用本地时间，可以课后执行SQL语句同步：

SET GLOBAL time_zone = '+08:00';

或者修改MySQL配置文件my.cnf（Windows下为my.ini），在[mysqld]段落中加入：

default-time-zone = '+08:00'

修改后重启MySQL服务生效,这个方案适用于需要长期固定时区的场景，一次性配置好后，IDEA连接时不写serverTimezone参数也能正常通过。

连接成功后，怎样验证不是“假连接”

在IDEA的Database面板里看到绿色勾,只说明IDEA和数据源之间的桥梁通了，这一步成功只代表驱动加载和网络连通性无误，不代表你的业务代码能跑通，真正的验证分为三个阶梯：

第一步，用IDEA自带控制台执行SQL。 在Database面板中选中目标数据库，按Ctrl+Enter打开查询控制台，执行SELECT 1或SHOW TABLES，这一步能确认当前账号具备读权限。

第二步，在项目中写最小JDBC代码验证。 新建一个普通的Java类，仿照下面这个最小结构测试：

Class.forName("com.mysql.cj.jdbc.Driver");
Connection conn = DriverManager.getConnection(
    "jdbc:mysql://localhost:3306/database_name?useSSL=false&serverTimezone=UTC",
    "root", "password"
);
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT VERSION()");
if (rs.next()) {
    System.out.println(rs.getString(1));
}
conn.close();

控制台能打印出MySQL版本号,说明Java代码层面的连接完全没问题，这里的密码字段建议直接替换为你的实际密码，不要照抄示例里的内容。

第三步，排查连接池配置。 如果你使用的是Spring Boot框架，数据源配置通常写在application.yml里，此处配置的错误会导致项目启动时数据源初始化失败，但IDEA面板不受影响，典型配置如下：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/database_name?useSSL=false&serverTimezone=UTC&characterEncoding=utf8
    username: root
    password: yourpassword
    driver-class-name: com.mysql.cj.jdbc.Driver

项目能正常启动,并且调用Mapper接口返回数据，这才算整个链路走通了，面板里连接成功仅仅是让IDEA能预览表结构和执行查询，和业务代码是两条互相独立的路径。

常见误区：IDEA面板显示连接失败，但代码里却能连上

有时会碰到一种看似矛盾的情况：IDEA自己的数据源配置报连接失败，但业务代码通过JDBC或mysql命令行工具能正常访问数据库，这种情况多数是因为IDEA使用的驱动版本与数据库不兼容。

IDEA自带的数据源工具默认使用自身内置的驱动版本,不一定和你项目里pom.xml指定的驱动一致，解决方法很直接：在Database面板中，选Advanced标签页，将Driver属性改为你项目实际使用的驱动版本，或者手动指定本地的jar包路径。

另一种可能性是连接参数在IDEA的图形界面中传递不完整,比如密码中包含、、等特殊字符，在IDEA表单里直接填写没什么问题，但如果通过URL注入的方式传递，则需要做URL编码，这就容易导致IDEA连接时解析出错。

Q&A：idea连接mysql数据库常见疑问

idea连接mysql数据库时提示Public Key Retrieval is not allowed怎么解决？

MySQL 8.0默认使用caching_sha2_password认证插件，在首次连接时要求客户端请求服务器的公钥，如果连接URL没有明确允许公钥检索，就会抛出这个异常，在JDBC URL末尾追加allowPublicKeyRetrieval=true即可恢复连接，参数会明文传输，但本地开发场景下风险可接受，生产环境建议采用其他认证方式。

idea连接mysql数据库8.0时下载驱动失败怎么办？

检查网络环境是否能够访问Maven中央仓库,IDEA下载驱动时默认从repo1.maven.org拉取，国内网络环境下可能较慢或超时，可在IDEA的Settings -> Build, Execution, Deployment -> Build Tools -> Maven中设置国内镜像后重试，另一种方式是从MySQL官网手动下载mysql-connector-j的jar包，然后在数据源配置界面的Driver标签页中，点击号手动添加该jar包，IDEA会优先使用本地驱动。

本地启动项目时Spring Boot报错找不到驱动类，但IDEA Database面板连接正常？

IDEA面板使用内置驱动连接成功,只能证明MySQL服务可达，并不能说明项目类路径下存在驱动依赖，检查pom.xml中是否引入了mysql-connector-j依赖，以及driver-class-name配置是否与依赖版本匹配，MySQL 8.0以上版本驱动类名是com.mysql.cj.jdbc.Driver，旧版本是com.mysql.jdbc.Driver，混淆这两个类名会直接导致启动时报ClassNotFoundException。