在IntelliJ IDEA中配置连接MySQL数据库，本质是通过数据库工具窗口添加数据源，填写连接信息并测试驱动连通性，这是Java开发中数据持久化的基础操作。
IntelliJ配置MySQL数据库连接的核心步骤
配置过程并不复杂,但每一步都有细节需要留意，从环境准备到驱动加载，再到测试连通，我们逐一拆解。
准备IntelliJ和MySQL的配置环境
在开始操作前,确保以下三项工作就绪，缺了任何一项，后续步骤都可能卡住。
- MySQL服务必须运行，本地开发时，确认MySQL服务已启动，Windows下可在服务管理器中查看，Linux或macOS下使用
systemctl status mysql或mysql.server status，如果服务未启动，连接时会直接报错，连数据库都找不到。 - IntelliJ IDEA版本选择，数据库工具是IntelliJ IDEA Ultimate版内置的功能，如果你使用的是Community版，需要额外安装Database Tools插件，业内专家指出，绝大多数Java开发者选择Ultimate版，因为除了数据库工具，它还包括Spring、Hibernate等框架支持，确认你的IDE版本后，在Settings > Plugins中搜索“Database Tools and SQL”并启用。
- MySQL JDBC驱动准备，IntelliJ在首次连接时会自动下载驱动，但国内网络环境可能导致下载超时，建议提前从MySQL官网下载Connector/J驱动包（jar文件），版本号与MySQL服务端匹配，通常情况下，MySQL 5.x使用5.1.x驱动，MySQL 8.x使用8.0.x驱动，下载后放在本地目录，后续手动添加。
怎么在IntelliJ IDEA中配置MySQL数据库连接
这是整个流程的核心,操作路径如下。
- 打开IntelliJ IDEA，点击右侧边栏的“Database”工具窗口，或者通过菜单栏View > Tool Windows > Database打开。
- 点击“+”图标，选择“Data Source” > “MySQL”，这一步会弹出数据源配置对话框。
- 填写连接信息：
- Host：本机填
localhost或0.0.1，远程服务器填IP地址。 - Port：默认
3306，你改了端口就填实际端口。 - Database：要连接的数据库名称，比如
test_db，如果不填，连接后会看到所有数据库列表。 - User：MySQL用户名，常用
root。 - Password：对应用户的密码。
- Host：本机填
- 点击“Test Connection”按钮，如果IntelliJ没有自动检测到驱动，会提示“Download missing driver files”，点击下载，等待完成，如果下载失败，转到手动添加驱动步骤。
- 测试成功后会显示“Connection successful”绿色提示，点击“Apply”和“OK”保存配置。
配置完成后,在Database窗口就能看到数据源节点，展开后可以浏览表、视图、存储过程等对象。
解决IntelliJ连接MySQL时的驱动和时区问题
实际配置中,最常遇到两个问题：驱动下载失败和时区不匹配，下面分别处理。
驱动下载失败的处理方法
如果你在测试连接时遇到“Cannot download driver”或“Driver files not found”，可以手动添加。
- 在数据源配置界面,点击“Driver”下拉列表，选择“MySQL”。
- 切换到“Driver files”选项卡，点击“+”号，选择你事先下载好的JDBC驱动jar包。
- 添加完成后,再次点击“Test Connection”，通常能正常连接。
时区设置错误导致连接失败
MySQL 8.0版本默认使用UTC时区，而本地系统可能使用Asia/Shanghai，连接时会出现“The server time zone value ‘X’ is unrecognized”错误。
解决方案有两种：
- 在MySQL命令行中执行
SET GLOBAL time_zone = '+8:00';，永久修改全局时区。 - 或者在IntelliJ的连接配置中,URL后面添加参数
?serverTimezone=Asia/Shanghai。jdbc:mysql://localhost:3306/test_db?serverTimezone=Asia/Shanghai。
进阶：利用IntelliJ数据库工具管理MySQL数据
配置连接只是第一步,日常开发中你还会频繁使用IntelliJ的数据库工具来执行SQL、查看结果、修改表结构，这些操作能让你在IDE内部完成数据管理，不需要再打开独立的客户端。
在控制台执行SQL查询
在Database窗口中,右键点击数据源，选择“Open Console”，会打开一个SQL控制台，直接输入SQL语句运行，控制台支持自动补全表名和字段，提高编写效率，如果需要执行多条语句，分号隔开，点击运行全部。
可视化编辑表结构和数据
- 双击表名,在弹出的窗口中可以查看所有数据行，支持直接编辑单元格内容，修改后自动保存。
- 右键表名,选择“Modify Table”，可以增加、删除字段，修改类型和默认值，这些操作会生成对应的DDL语句，IntelliJ会提示你是否执行。
导出和导入数据
当你需要迁移数据库或备份数据时,IntelliJ提供了导出功能。
- 右键数据源或数据库,选择“Export Data to File…”，可以选择导出为SQL脚本、CSV、JSON等格式，导出时能指定表范围、是否包含数据等。
- 导入数据同样简单,右键数据源，选择“Import Data from File…”，支持CSV或SQL文件，导入前需要确认字段映射是否正确。
IntelliJ配置MySQL数据库连接常见问题解答
以下问题来自实际开发中遇到的反馈,几乎每个新人都可能碰到。
问题1：连接时提示“Access denied for user ‘root’@’localhost’”
这是用户名或密码错误,或者用户权限不足，先确认密码是否正确，密码中含有特殊字符时，需要在URL中对字符进行编码，或者直接在密码框中输入原文，如果密码正确，检查MySQL的user表，确认root用户是否允许从localhost登录。SELECT host, user FROM mysql.user; 如果host不是localhost，需要修改。
问题2：连接成功后，在Database窗口中看不到任何表
这是因为你在连接时没有指定Database,或者连接的数据库用户没有访问某些库的权限，在数据源配置界面，点击“Schemas”选项卡，勾选你需要显示的数据库，如果列表为空，说明当前用户没有权限，需要执行GRANT SELECT ON mydb. TO 'user'@'host'; 授权。
问题3：驱动版本与MySQL版本不兼容，怎么办
MySQL 5.5或5.6使用较旧的驱动（5.1.x），MySQL 8.0以上必须使用8.0.x驱动，如果驱动版本不匹配，连接时会报“Unable to load authentication plugin ‘caching_sha2_password’”错误，这是因为MySQL 8.0默认使用caching_sha2_password插件，而旧驱动不支持，解决方法是下载最新的MySQL Connector/J 8.0驱动，并在连接URL中添加allowPublicKeyRetrieval=true和useSSL=false参数。
从环境准备到驱动配置,再到解决常见错误，IntelliJ连接MySQL数据库的每一步都有明确的操作路径，掌握这些要点后，你的开发环境搭建效率会明显提升，后续的数据操作也能在IDE内完成。
首发原创文章，作者：王坚，如若转载，请注明出处：https://test.idctop.com/article/558530.html
