webstorm首次连mysql需三步：先手动添加mysql-connector-j正确版本驱动，再激活连接并刷新元数据，最后确认事务已提交或启用auto-commit，缺一不可。
WebStorm 首次连 MySQL，光点“Test Connection”成功不代表能查表、写 SQL 或看到数据——驱动没对、元数据没刷、事务没提交，三者缺一都会卡住。
Driver not found？别点 Download，手动加 mysql-connector-j
WebStorm 点“Download missing driver files”只会下旧版 mysql-connector-java（已弃用），而 MySQL 8.0+ 服务端要求的是 mysql-connector-j-8.0.xx.jar。
- 去 MySQL 官网下载页，选 Platform Independent → ZIP → 解压后取
mysql-connector-j-8.0.33.jar（或最新 8.0.x） - 若连的是 MySQL 5.7 或更老版本，改用
mysql-connector-j-5.1.49.jar，否则握手失败报Unknown system variable 'query_cache_size' - Database 工具窗口右上角齿轮 →
Driver and Data Source Setup→ 选中 MySQL 驱动 → 右侧+→Custom JARs→ 添加该 JAR
测试成功却看不到表？必须手动 Refresh Database
“Test Connection” 绿色对勾只表示账号能登录服务器，不代表 WebStorm 已加载库结构。空节点、FROM 不补全、字段无高亮，全是元数据没刷出来的表现。
MySQL（Linux）
下载
MySQL 9.6.0是面向Linux平台的2026年创新版本，核心架构迎来重大革新。其将外键约束与级联操作从InnoDB引擎层上移至SQL层，确保所有数据变更均被完整记录至Binlog，彻底解决了CDC（变更数据捕获）与主从复制中的数据不一致难题。此外，该版本引入container_aware启动选项以原生适配容器环境，并对审计日志进行了组件化重构，为追求极致数据一致性与云原生体验的开发者提供了全新选择。
- 先双击数据源，确认右下角出现绿色圆点（连接已激活）
- 右键该数据源 →
Refresh Database（或Ctrl+F5/Cmd+F5） - 如果提示
Cannot load tables，检查权限：GRANT SELECT ON mydb.* TO 'user'@'%'; FLUSH PRIVILEGES; - 若只用了部分 schema（如
myapp_dev），进Data Source Properties→Schemas标签页 → 勾选对应库名再刷新
INSERT 执行了但数据没变？看右下角 Transaction: ON
WebStorm 数据库控制台默认关闭 auto-commit，所有 DML 操作都在事务里——不提交就只是临时状态，哪怕显示 1 row affected，关掉控制台或重启 IDE 就回滚。
- 看右下角状态栏：若有
Transaction: ON，说明当前处于事务中 - 手动提交：点击工具栏
Commit图标（或Ctrl+Enter/Cmd+Enter） - 永久关闭事务模式：进
Data Source Properties→Options标签页 → 勾选Auto-commit
最容易被忽略的其实是三件事的顺序：先装对驱动，再连上并激活连接，最后刷新元数据——中间跳过任意一步，SQL 编辑器里的表名补全、字段高亮、执行结果持久化，全都会失效。
