PhpStorm连MySQL失败90%是host、权限、驱动或编码配置错误：localhost与127.0.0.1权限不互通，须用后者；确认服务运行及端口正确；驱动需用mysql-connector-java-8.0.33.jar并配对com.mysql.cj.jdbc.Driver类名；URL加时区、SSL及UTF-8参数；全局编码设UTF-8；Database字段勿空且启用内省。
Connection failed？先别怪 PhpStorm，90% 是 host 或权限配错了
PhpStorm 连不上 MySQL，大概率不是 IDE 的问题，而是 host、port、用户权限或驱动没对上。尤其注意：localhost 和 127.0.0.1 在 MySQL 权限体系里是两个不同 host —— 'user'@'localhost' 不等于 'user'@'127.0.0.1'，前者走 Unix socket，后者走 TCP，权限不互通。
- 优先用
127.0.0.1，避开 socket 路径干扰 - 确认 MySQL 服务在运行：
sudo systemctl status mysql（Linux/macOS）或查 Windows 任务管理器中是否有mysqld.exe - 检查端口：Docker 容器、MAMP、XAMPP 常把端口映射成
3307等，别硬套默认3306 - 命令行先通再配：
mysql -h 127.0.0.1 -P 3306 -u your_user -p，能连上，再进 PhpStorm
No suitable driver found？驱动版本和类名必须严丝合缝
报这个错，说明 PhpStorm 没加载到可用的 JDBC 驱动。它不依赖你本地装的 mysql 命令，只认 mysql-connector-java JAR 文件，且版本、类名、URL 参数必须匹配。
- 删掉所有旧驱动：
Database工具窗口 → 右上角齿轮 →Driver Files→ 全部移除 - 下载推荐版本：
mysql-connector-java-8.0.33.jar（适配 MySQL 5.7+ 和 8.x），避免用8.3.x（部分与 PhpStorm 2023.2 前版本有 TLS 握手失败） - Class 名必须填对：
com.mysql.cj.jdbc.Driver（MySQL 8.0+），不是旧版的com.mysql.jdbc.Driver - URL 后补参数：
?serverTimezone=UTC&allowPublicKeyRetrieval=true&useSSL=false，否则 MySQL 8.0+ 很可能卡认证
中文乱码 or 查询卡住？字符集和编码得从连接层对齐
执行 SQL 后字段显示 ???，或 SELECT COUNT(*) 卡几秒才出结果，基本是字符集没初始化好。PhpStorm 的「Console」模式不会自动执行 SET NAMES，靠临时语句不可靠。
- JDBC URL 末尾加：
&characterEncoding=utf8mb4&useUnicode=true，确保支持 emoji 和完整 UTF-8 - PhpStorm 全局编码必须设为 UTF-8：
Settings → Editor → File Encodings→Global Encoding和Project Encoding都选UTF-8 - 别指望数据库里
SET NAMES utf8mb4能持久生效 —— 它只作用于当前会话，且 PhpStorm 不保证每次新开 Console 都重跑
Test Connection 成功但表不显示？检查数据库名和内省范围
连接测试绿了，但左侧 Database 工具窗口里空空如也，没表、没 schema，常见原因是没指定数据库名，或没启用内省（introspection）。
立即学习“PHP免费学习笔记（深入）”；
- 创建数据源时，
Database字段**不要留空**（除非你明确要连实例级，而非库级） - 右键数据源 →
Properties→Schemas标签页 → 勾选目标数据库（如myapp_dev），或点Refresh手动触发内省 - 如果用了 MySQL 8.0+ 的新认证插件（
caching_sha2_password），而驱动或服务端未兼容，也可能导致内省失败 —— 此时回退用mysql_native_password创建用户更稳
最容易被忽略的其实是 host 和权限的分离逻辑：你用 127.0.0.1 连，就得有对应 host 的用户；驱动类名写错一个字母、JDBC URL 少个 &、全局编码漏改一处，都会让连接看起来“半成功”。这些点不显眼，但卡人最久。
