最常见报错是“no suitable driver found”，因未加载对应jdbc驱动jar；执行卡住多因连接被占用；中文乱码源于url缺编码参数；导入sql后需reload database刷新元数据；驱动与数据库版本须严格匹配。
连接失败：Driver not found 或 No suitable driver
这是最常遇到的报错，典型错误信息是 java.sql.SQLException: No suitable driver found 或 Driver not found: com.mysql.cj.jdbc.Driver。根本原因不是 IDEA 没装插件，而是它没加载对应数据库的 JDBC 驱动 JAR。
实操建议：
- 点开 Database 工具窗口右上角的
+→Data Source→ 选具体数据库（如MySQL），别选Generic后自己填 URL —— 那样容易漏驱动 - 在新建数据源的配置页，切换到
Driver files标签页，点击右侧Download按钮（IDEA 会自动匹配最新稳定版）；如果网络受限，手动下载后点+添加本地mysql-connector-java-8.0.33.jar这类文件 - 确认驱动类名正确：
MySQL8.x 用com.mysql.cj.jdbc.Driver，5.x 用com.mysql.jdbc.Driver；PostgreSQL 用org.postgresql.Driver—— 类名错一个字符就报No suitable driver
SQL 执行卡住或提示 “Connection is busy”
执行查询时光标一直转圈，或弹出 Connection is busy 提示，通常不是数据库挂了，而是当前连接被另一个长期运行的操作（比如没加 LIMIT 的全表扫描、大事务）占着没释放。
实操建议：
- 检查右下角状态栏：看到
DB: xxx (running)就说明有语句正在跑，点旁边的Cancel图标（×）可中断 - 避免在生产环境直接连库执行
SELECT *—— 在Database工具窗口里右键表名 →Jump to Query Console，IDEA 默认会给新控制台加上LIMIT 1000，但这个行为可被关闭，务必确认设置里Enable LIMIT clause by default是勾选状态 - 如果频繁卡住，检查连接池设置：在数据源配置的
Advanced标签页里，max connections别设太高（默认 5–10 足够），否则本地机器扛不住并发
中文乱码：表名/字段名/查询结果全是问号
建表时用了 utf8mb4，但 IDEA 里显示字段名是 ???，或者 SELECT 出来中文变方块，问题大概率出在连接参数，而不是数据库或系统编码。
实操建议：
- 在数据源配置的
General标签页，找到URL输入框，确保末尾带了编码参数：MySQL 加&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai；PostgreSQL 加?charset=utf8 - 别依赖 IDEA 自动拼接 URL —— 它有时会漏掉
useSSL=false（尤其 MySQL 8.0+），导致连接失败或降级成不安全协议，间接影响字符集协商 - 验证是否生效：连上后执行
SHOW VARIABLES LIKE 'character_set%';，重点看character_set_client、character_set_connection、character_set_results三项是否都是utf8mb4
导入 SQL 文件后没刷新表结构
用 File → Import → SQL Files... 导入了一个 schema.sql，但在 Database 工具窗口里看不到新表，右键刷新也没用 —— 这是因为导入操作只是把 SQL 发给数据库执行，并不会主动触发 IDEA 的元数据缓存更新。
实操建议：
- 导入完成后，右键对应数据源 →
Reload database（不是Refresh），这个操作会重新拉取表、列、索引等完整元数据 - 如果只想刷新单个 schema，右键该 schema →
Reload schema，比全局 reload 快；但注意：某些数据库（如 Oracle）不支持按 schema reload，只能 reload 整个连接 - 导入前确认当前连接用户有
CREATE TABLE权限，否则 SQL 执行失败但 IDEA 不一定报错，表自然不会出现
驱动版本和连接参数必须跟数据库服务端版本对齐，这点最容易被跳过 —— 比如用 MySQL 8 驱动连 MySQL 5.7，可能连得上但 information_schema 查询异常；反过来用老驱动连新库，时间类型或 JSON 字段直接解析失败。
