IDEA怎么连接MySQL数据库？，连接不上怎么办？

如果在IDEA中连接MySQL数据库失败，绝大多数情况下是驱动未配置、时区参数缺失或防火墙拦截这三个原因造成的，按照下文步骤逐一排查即可解决。

连接前的准备工作：驱动与依赖

很多朋友刚装好IntelliJ IDEA，兴致勃勃地打开Database面板，输入主机名和密码，结果直接弹出一个红色报错，先别急着怀疑服务器，多数情况下问题出在驱动上。

数据库驱动怎么装

IDEA自带的驱动列表往往版本较旧，和本地MySQL版本不匹配，操作路径是：View -> Tool Windows -> Database，点击左上角号，选择Data Source -> MySQL，在Driver下拉菜单里如果找不到合适版本，点击Download按钮,等待进度条走完即可。

用Maven或Gradle做Java项目的话，还需要在pom.xml中引入依赖，以MySQL 8.0以上版本为例，mysql-connector-java的groupId是com.mysql，artifactId是mysql-connector-j，版本号推荐和你的MySQL服务端版本接近，引入依赖后记得刷新Maven项目,否则IDEA可能识别不到新加入的jar包。

连接URL的写法有讲究

连接字符串看似简单，但埋着不少坑,最基本的格式是：

jdbc:mysql://localhost:3306/数据库名

但如果你用的是MySQL 8.0以上的版本，必须加上时区参数，否则会报Server returns invalid timezone错误,完整的写法是：

jdbc:mysql://localhost:3306/数据库名?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true

注意allowPublicKeyRetrieval=true这个参数，在MySQL 8.0的某些认证插件下会用到,不加的话可能遇到公钥检索失败的报错。

idea连接mysql失败的常见场景与解决步骤

在真实的开发环境里，连接失败的情况五花八门，这里把最常见的几个场景拆开来讲,你可以按顺序排查。

密码正确却报Access denied

这个报错的全称通常是Access denied for user 'root'@'localhost'。多数情况下不是密码错了，而是MySQL的认证插件和客户端不兼容，MySQL 8.0默认使用caching_sha2_password认证，而有些旧版本的驱动或IDEA内置驱动只支持mysql_native_password。

解决办法有两条路，一条是升级驱动到最新版本,另一条是在MySQL命令行中执行：

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码'; FLUSH PRIVILEGES;

执行完毕后重启MySQL服务，再回到IDEA里测试连接,基本就能通过。

连接超时或者无法访问

如果报错是Communications link failure或者Connection timed out，问题多半出在网络层面，先确认MySQL服务是否真的在运行，在命令行执行service mysql status（Linux）或net start mysql（Windows），服务正常运行的话，再用telnet 127.0.0.1 3306测试端口是否通畅。

如果服务器在远程，还要检查防火墙是否放行了3306端口，云服务器的话，记得去安全组里添加入站规则，这里有个细节容易被忽略：MySQL默认只监听127.0.0.1地址，如果远程连接不上，需要修改my.cnf配置文件中的bind-address，将其改为0.0.0,然后重启MySQL。

驱动类找不到

报错信息里出现ClassNotFoundException: com.mysql.jdbc.Driver，说明驱动jar包没有正确加载，注意一个细节：MySQL 8.0的驱动类名是com.mysql.cj.jdbc.Driver，不是旧的com.mysql.jdbc.Driver，在使用IDEA自带的数据库面板时，一般不需要手动填写驱动类名，但如果你写的是纯JDBC代码，务必检查Class.forName()里的字符串是否正确。

连接成功后的使用技巧

连接上MySQL只是第一步，真正用得顺手还需要掌握一些技巧，这里聊两个高频场景：字符集设置和代码提示功能。

设置UTF-8编码避免中文乱码

用IDEA查询数据库里的中文数据，结果在控制台里显示成问号或者乱码，这个问题的根源在于连接字符集和控制台编码不一致。

在IDEA的数据库连接配置界面，找到Advanced标签页，在key value列表里添加characterEncoding为utf8，useUnicode为true，在VM options里加上-Dfile.encoding=UTF-8，配置文件方面，my.cnf中需要确保：

[client] default-character-set=utf8mb4 [mysql] default-character-set=utf8mb4 [mysqld] character-set-server=utf8mb4

注意：utf8mb4是utf8的超集，支持完整的Unicode字符，包括emoji，如果数据库已经建好,需要修改库和表的字符集：

ALTER DATABASE 数据库名 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ALTER TABLE 表名 CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

让代码提示恢复正常

有些朋友发现IDEA连上数据库后，在写SQL语句时没有任何字段名提示，或者提示出来的全是数据库的真实表名而不是项目里的实体类,这里涉及IDEA的三个关键设置：

• Language Injection功能：在Mapper.xml文件里，按住Alt + Enter，选择Inject language or reference，再选MySQL,这样SQL语句就能识别表和字段。
• Database面板的Schema选择：在Database面板里展开你的连接，右键选择Database Tools -> Manage Shown Schemas，勾选你实际使用的数据库，不勾选的话,IDEA可能扫描不到表结构。
• 缓存失效：如果修改了表结构但提示不更新，执行File -> Invalidate Caches / Restart,清理缓存后重启IDEA。

控制台 Console 使用技巧

IDEA自带的数据库控制台比命令行好用得多，在Database面板选中某个数据库，按F4或者右键选择Open Console，就能打开一个SQL编辑窗口，这里支持代码补全、错误高亮、格式化等操作。写好SQL后，用Ctrl + Enter执行，而不是Ctrl + Enter这个快捷键在控制台里是执行当前语句,不用担心误触。

版本兼容性：IDEA与MySQL版本搭配

很多初学者栽在版本兼容性上，IDEA 2020年之前的版本，对MySQL 8.0的支持不够完善，连接时容易报错。行业共识认为，IDEA 2020.1以上版本配合MySQL 5.7或8.0都是比较稳妥的组合。

这里整理一个简单的对照表,供参考：

如果你的IDEA版本比较老，又不想升级，建议在连接时选择mysql_native_password认证方式的用户,避免驱动不兼容的问题。

常见问题快速问答

问：IDEA连接MySQL时提示表不存在，但明明有这张表

检查Database面板中当前选中的Schema是否正确，右键连接 -> Database Tools -> Manage Shown Schemas，确认你要用的数据库名称前打上了勾，SQL语句中的表名是否带了多余的前缀或反引号,也会导致识别失败。

问：IDEA连接MySQL一段时间后自动断开怎么处理

这是MySQL的wait_timeout参数导致的，默认值为8小时，空闲连接会被服务端主动断掉，在连接配置的Advanced标签页中，添加autoReconnect为true，maxReused为true,同时修改MySQL的配置文件：

[mysqld] wait_timeout=2147483 interactive_timeout=2147483

问：在IDEA中怎么查看MySQL的实时执行日志

在Database面板中，右键连接 -> Tools -> Show Logs，可以查看MySQL的通用查询日志，但此功能需要MySQL开启general_log,在MySQL命令行中执行：

SET GLOBAL general_log = 'ON'; SET GLOBAL log_output = 'TABLE';

日志会写入mysql.general_log表,IDEA会以表格形式展示。

连接MySQL这件事，本质上就是驱动、URL、认证方式、网络可达性四个要素的排列组合，按照本文的排查顺序，从驱动配置开始，逐个验证URL参数、时区设置、防火墙规则，绝大多数问题都能在十分钟内解决，熟练掌握这些操作后，你会发现IDEA的数据库工具远比Navicat这类独立客户端更顺手,毕竟代码和SQL在同一个窗口就能完成交互。