IDEA连接MySQL数据库的完整流程并不复杂，核心在于驱动版本匹配、URL参数写法和数据库服务状态三大前提。 把这三点弄清楚，从配置数据源到代码访问，一条路走通，多数连接失败的问题都能快速定位。
连接前，先把这三个问题在脑子里过一遍
不少开发者在IDEA里折腾半天连不上数据库,其实问题不在操作，而在环境准备，动手之前，先检查三件事。
第一，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版本为例，数据库工具已经内置，不需要额外安装插件，操作路径如下：
- 点击IDEA右侧边栏的Database面板，如果没有，点击
View -> Tool Windows -> Database调出。 - 点击面板左上角的加号，选择
Data Source，再选MySQL。 - 在弹出窗口中填写连接信息：
- Host：
localhost（本地）或远程服务器IP - Port：
3306 - User：
root或你的业务账号 - Password：对应密码
- Host：
- 点击
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=trueserverTimezone=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报错，多半出在时区与公钥校验
把常见报错信息整理成一张排查表,遇到问题直接对照处理，比读异常堆栈更高效。
| 报错信息 | 可能原因 | 解决方式 |
|---|---|---|
Server returns invalid timezone |
数据库时区设置不兼容 | URL末尾追加serverTimezone=UTC |
Public Key Retrieval is not allowed |
0版本的公钥检索机制 | URL末尾追加allowPublicKeyRetrieval=true |
Access denied for user |
用户名或密码错误 | 检查密码是否包含特殊字符，需要URL编码 |
Could not create connection to database server |
驱动版本与数据库版本不匹配 | 升级或降级驱动版本，尽量对齐大版本 |
Connection refused |
服务未启动或端口被防火墙拦截 | 检查MySQL进程和3306端口连通性 |
Unknown database |
URL中指定的数据库名不存在 | 确认数据库名称拼写正确且已创建 |
时区报错在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。
首发原创文章，作者：王坚，如若转载，请注明出处：https://test.idctop.com/article/584235.html
