WebStorm连接数据库需同时满足插件启用、驱动加载、网络可达、权限到位四条件；缺一则出现灰色图标、测试失败或“No data sources configured”，配置完成不等于实际连接，测试成功不等于能查表，绿色圆点亮不等于事务已提交。
WebStorm 连接数据库不是配完参数就自动通的，它必须同时满足插件启用、驱动加载、网络可达、权限到位这四件事。少一个，你看到的都是灰色图标、测试失败或“No data sources configured”。
Database Tools and SQL 插件没启用，整个功能就不存在
这个插件默认启用，但一旦被手动禁用，Database 工具窗口、SQL 文件高亮、表名补全、查询执行按钮——全都没了。不是卡顿，是根本没加载。
- 按
Ctrl+Alt+S打开设置 →Plugins→ 搜索Database Tools and SQL - 确认复选框已勾选；如果灰色不可点，重启 WebStorm 再试
- 改完别忘了点右下角
Apply，否则设置不生效
MySQL 连接报 “Driver not found” 或 “Unknown system variable 'query_cache_size'”
WebStorm 不自带 MySQL JDBC 驱动，必须手动下载并绑定 JAR。报错不是因为版本新旧冲突，而是驱动根本没加载或版本错配。
- 去 MySQL 官网下载
mysql-connector-j（注意不是旧名mysql-connector-java） - MySQL 5.7 及更早：用
mysql-connector-j-5.1.49.jar - MySQL 8.0+：必须用
mysql-connector-j-8.0.xx.jar，否则握手失败报query_cache_size错误 - 添加路径：
Database工具窗口右上角齿轮 →Driver and Data Source Setup→ 选中 MySQL 驱动 → 点右侧+→Custom JARs→ 选中 JAR 文件
PostgreSQL 连上了但看不到表，或者双击表报 “permission denied for schema public”
绿色对勾只代表 TCP 层连通、账号能登录，不代表有权限读取 schema 或表。WebStorm 默认只 introspect public schema，且不自动加双引号处理大小写。
- 检查用户是否拥有
USAGE权限：GRANT USAGE ON SCHEMA public TO your_user; - 检查表级
SELECT权限：GRANT SELECT ON ALL TABLES IN SCHEMA public TO your_user; - 如果表在非
publicschema（比如myschema），进数据源设置 →Schemas标签页 → 勾选对应 schema 名 - 如果 schema 名含大写字母（如
"MySchema"），WebStorm introspection 不会自动加引号，要么改用小写名，要么在 SQL 里显式写"MySchema".mytable
连接成功但执行 INSERT/UPDATE 后数据没变，控制台却显示 “1 row affected”
这是 WebStorm 数据库控制台默认关闭 auto-commit 的结果。所有 DML 都在事务里，不提交就是临时状态。
- 看右下角状态栏：如果显示
Transaction: ON，说明当前处于事务模式 - 手动提交：执行完 DML 后，点工具栏上的
Commit按钮（绿色对勾图标），或按Ctrl+Enter（Mac 为Cmd+Enter） - 想永久开启 auto-commit：进
Settings → Tools → Database → Data Views→ 勾选Auto-commit
最常被忽略的是：配置完成 ≠ 实际连接，测试成功 ≠ 能查表，绿色圆点亮了 ≠ 事务已提交。每层都得单独验证，不能靠“看起来没问题”跳过。
