intellij idea 连接 mysql 失败需依次排查：一、安装匹配的 jdbc 驱动并确认 driver class；二、修正 url 格式及必需参数（如 usessl=false、servertimezone、allowpublickeyretrieval）；三、将用户认证插件改为 mysql_native_password；四、确保端口可达、bind-address 配置正确且防火墙放行；五、在 advanced 中禁用 ssl 强制要求并显式设置 servertimezone。

如果您在 IntelliJ IDEA 中使用数据库工具连接 MySQL 时失败，通常涉及驱动缺失、版本不兼容、URL 格式错误或认证配置不当等问题。以下是针对该问题的多种排查与解决路径：

一、验证并安装正确的 MySQL JDBC 驱动

IDEA 数据库工具依赖 JDBC 驱动与 MySQL 通信，若驱动未安装、版本过旧或与 MySQL 服务端版本不匹配，将导致连接中断。

1、在数据库工具窗口右上角点击 “+” → “Data Source” → “MySQL”，打开连接配置面板。

2、点击面板底部的 “Download missing driver files” 按钮，触发自动下载。

3、若自动下载失败或提示“Connection refused”，手动下载：访问 https://dev.mysql.com/downloads/connector/j/，选择与 MySQL 服务端大版本一致的驱动（如 MySQL 8.0.x 请选 mysql-connector-j-8.3.x.jar）。

4、点击配置面板中的 “Driver Files” 选项卡，点击 “+” 添加已下载的 JAR 文件路径。

5、在 “Driver Class” 下拉框中确认显示为 com.mysql.cj.jdbc.Driver（MySQL 8.0+）或 com.mysql.jdbc.Driver（MySQL 5.7 及更早）。

二、检查 JDBC URL 格式与参数完整性

MySQL 连接 URL 必须包含协议、主机、端口、数据库名及必要参数；缺少或错写任意部分均会导致连接拒绝或超时。

1、确认基础格式为：jdbc:mysql://host:port/databaseName，例如 jdbc:mysql://localhost:3306/testdb。

2、在 URL 末尾追加必需参数：添加 ?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true（MySQL 8.0+ 必须含 allowPublicKeyRetrieval=true，否则报“Public Key Retrieval is not allowed”）。

3、若使用 IPv6 地址，需将 host 部分用方括号包裹，例如：jdbc:mysql://[::1]:3306/testdb。

4、检查端口是否被占用或 MySQL 服务未监听默认 3306：在终端执行 netstat -an | grep 3306（Linux/macOS）或 netstat -ano | findstr :3306（Windows）验证端口状态。

三、核对用户权限与认证插件兼容性

MySQL 8.0 默认使用 caching_sha2_password 认证插件，而旧版驱动或 IDEA 内置驱动可能仅支持 mysql_native_password，引发“Client does not support authentication protocol”错误。

1、登录 MySQL 命令行（需 root 权限），执行：SELECT user, host, plugin FROM mysql.user; 查看目标用户的 plugin 字段值。

2、若目标用户 plugin 为 caching_sha2_password，执行以下命令切换为兼容插件：ALTER USER 'username'@'host' IDENTIFIED WITH mysql_native_password BY 'password';。

3、执行 FLUSH PRIVILEGES; 刷新权限。

4、重启 MySQL 服务使更改生效（systemctl restart mysqld 或服务管理器中重启）。

四、验证网络连通性与防火墙设置

即使配置正确，本地网络策略或远程服务器防火墙也可能拦截连接请求，导致“Connection timed out”或“No route to host”。

1、在 IDEA 所在机器终端执行：telnet hostname 3306（Windows）或 nc -zv hostname 3306（Linux/macOS），测试端口可达性。

2、若连接失败，检查 MySQL 配置文件 my.cnf（或 my.ini）中 bind-address 是否设为 127.0.0.1（仅本地）；如需远程访问，应设为 0.0.0.0 或具体 IP，并确保 skip-networking 未启用。

3、检查操作系统防火墙：Linux 上运行 sudo ufw status，若启用则添加规则 sudo ufw allow 3306；Windows 上在“高级安全 Windows 防火墙”中新建入站规则放行 TCP 3306 端口。

五、检查 IDEA 数据源高级设置中的 SSL 与时区选项

SSL 强制启用或时区未显式声明常引发握手失败或时间转换异常，尤其在跨时区开发环境中。

1、在数据库连接配置面板中，切换至 “Advanced” 选项卡。

2、查找 “useSSL” 参数，将其值设为 false（开发环境非必须启用 SSL）。

3、查找 “serverTimezone” 参数，设为与系统一致的时区，例如 Asia/Shanghai；不可留空或填入 GMT+8 等非标准格式。

4、取消勾选 “Require SSL” 和 “Verify Server Certificate”（位于 SSL 子页签中）。