PhpStorm怎么连接MySQL数据库_PhpStorm Database数据库连接教程【推荐】

星宇姑娘_1535

星宇姑娘_1535

2026-04-08

281人浏览

原创

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字段勿空且启用内省。

phpstorm怎么连接mysql数据库_phpstorm 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)。

  • 创建数据源时,Database 字段**不要留空**(除非你明确要连实例级,而非库级)
  • 右键数据源 → Properties → Schemas 标签页 → 勾选目标数据库(如 myapp_dev),或点 Refresh 手动触发内省
  • 如果用了 MySQL 8.0+ 的新认证插件(caching_sha2_password),而驱动或服务端未兼容,也可能导致内省失败 —— 此时回退用 mysql_native_password 创建用户更稳

最容易被忽略的其实是 host 和权限的分离逻辑:你用 127.0.0.1 连,就得有对应 host 的用户;驱动类名写错一个字母、JDBC URL 少个 &、全局编码漏改一处,都会让连接看起来“半成功”。这些点不显眼,但卡人最久。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

4643

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

951

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1209

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

6621

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3363

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

6600

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

9081

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1230

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1072

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习