PHPStorm 连接 MariaDB 需使用 mariadb-ja va-client 驱动（org.mariadb.jdbc.Driver）而非 MySQL 驱动；认证失败时应升级驱动至 3.0+ 并添加 allowPublicKeyRetrieval=true 等参数；URL 须含数据库名且用户需有 INFORMATION_SCHEMA.SELECT 权限。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

PHPStorm 连接 MariaDB 时提示 “Driver not found” 或 “No database selected”

很多开发者第一次尝试时都会踩这个坑：PHPStorm 默认并不内置 MariaDB 驱动，它预装的是 MySQL 的 JDBC 驱动（mysql-connector-ja va）。问题在于，MariaDB 官方明确推荐使用自家的 mariadb-ja va-client。为什么？因为后者对 MariaDB 的独有特性——比如 SEQUENCE、CONNECT 引擎，以及高版本里的认证插件如 unix_socket 或 ed25519——支持得更加完整。直接套用 MySQL 驱动去连接 MariaDB 8.0 及以上版本，失败几乎是必然的。

那么，具体该怎么操作呢？

• 首先，在数据库工具窗口点击 “+” → “Data Source → MariaDB”。注意，这里一定要选“MariaDB”，而不是“MySQL”。如果下拉列表里压根没有 MariaDB 这个选项，那就说明驱动根本没加载上，需要手动添加。
• 接下来，通常会看到右下角有个 Download missing driver files 的按钮。这里有个细节：从 PHPStorm 2022.3 版本开始，这个自动下载功能默认抓取的是 MySQL 驱动。所以，稳妥起见，最好关掉自动下载，改用手动方式。
• 手动方式就是去 MariaDB 官网，下载最新的 mariadb-ja va-client-x.x.x.jar 文件。然后回到数据源配置页面，找到添加驱动的地方，通过 Driver Files → + → Custom JARs 的路径，把这个 JAR 文件添加进去。
• 最后，在 Driver class 一栏，正确填写 org.mariadb.jdbc.Driver。千万别填成 MySQL 的那个。

连接 MariaDB 10.6+ 报错 “Client does not support authentication protocol requested by server”

这个报错太经典了，本质上就是认证插件不兼容。MariaDB 从 10.4 版本开始，默认启用了更安全的认证方式，比如本地的 unix_socket 或者远程的 ed25519。而老版本的 JDBC 驱动根本不认识这些新协议，结果就是即使用户名密码百分百正确，连接请求也会被服务器无情拒绝。

解决思路可以分两步走：

立即学习“PHP免费学习笔记（深入）”；

• 先确认用户的认证方式：在数据库服务器上执行这条 SQL：

  SELECT User, Host, plugin FROM mysql.user WHERE User = 'your_user';

  如果查出来的 plugin 字段显示是 ed25519 或 unix_socket，那就别指望用默认驱动直接连上了。
• 临时解决方案（适合开发环境）：如果你有 root 权限，可以登录 MariaDB，将这个用户的认证插件改回旧的 mysql_native_password：

  ALTER USER 'your_user'@'%' IDENTIFIED VIA mysql_native_password USING PASSWORD('your_pass');

• 长期推荐的方案：保持服务器端先进的认证插件不变，而是在 PHPStorm 的连接 URL 后面追加几个关键参数。完整的 URL 看起来应该是这样：jdbc:mariadb://your_host:3306/your_db?allowPublicKeyRetrieval=true&useSSL=false&serverTimezone=UTC。同时，务必确保你使用的驱动是 mariadb-ja va-client 3.0+ 版本，因为它已经原生支持 ed25519 认证了。

测试连接成功但看不到表 / schema 列表为空

这种情况最让人头疼：明明测试连接显示“成功”，但左侧的数据库面板却空空如也。这通常不是连接本身的问题，而是权限不足或者连接参数有遗漏。PHPStorm 的数据库面板需要查询 INFORMATION_SCHEMA 来获取元数据，而 MariaDB 默认会对普通用户的这类访问做限制。

遇到这个问题，请按顺序检查以下几点：

• URL 里必须明确指定数据库名：这是一个非常常见的疏忽。URL 应该是 jdbc:mariadb://localhost:3306/your_db_name?useSSL=false 这样的格式。如果只写到端口号，像 jdbc:mariadb://localhost:3306/，连接虽然能建立，但因为没有指定默认库，PHPStorm 自然不知道去显示哪个库的表。
• 检查用户权限：连接用户至少需要对目标数据库有 SELECT 权限。更重要的是，从 MariaDB 10.5 开始，普通用户默认无法访问 INFORMATION_SCHEMA 视图。你需要显式授权：

  GRANT SELECT ON INFORMATION_SCHEMA.* TO 'your_user'@'%';

• 暂时关闭 SSL 选项：在 PHPStorm 的设置里，如果勾选了 Use SSL，但服务器端并没有正确配置证书，连接可能会以一种“静默失败”的方式通过，但无法获取数据。建议在排查问题时，先关掉 SSL，等基础连接和列表显示都正常后，再回来配置安全连接参数。

PHPStorm 中执行 SQL 提示 “Unknown system variable ‘sql_mode’”

这个错误提示是个明确的信号：驱动和 MariaDB 服务器之间的协议协商失败了。最常见的原因，要么是错误地使用了 MySQL 驱动来连接 MariaDB，要么就是驱动版本实在太老了（比如还在用 mysql-connector-ja va 5.1）。MariaDB 并不完全支持 MySQL 的所有系统变量别名，而一些旧的驱动却硬编码了这些查询语句。

验证和修复的步骤很清晰：

• 先确认数据库版本：在 PHPStorm 的数据库控制台里执行 SELECT VERSION();。确认返回的是类似 10.x.x-MariaDB 的字符串，而不是 8.0.x（MySQL）。
• 彻底重建数据源：最干脆的办法是删掉当前有问题的数据源配置，从头新建一个。这次，严格使用 mariadb-ja va-client 驱动，并确保驱动版本足够新。
• 避免驱动混用：不要在同一个 PHPStorm 项目里，让 MySQL 和 MariaDB 的数据源配置共享同一份驱动 JAR 文件，这很容易引起冲突。
• 升级 IDE：如果上述步骤都做了问题依旧，可以考虑将 PHPStorm 升级到 2023.2 或更高版本，这些版本对 mariadb-ja va-client 3.1 及以上的支持更加完善。

说到底，连接 MariaDB 时最棘手的往往不是连不上，而是连上了之后，却读不到表结构，或者执行 DDL 语句时报一些奇怪的语法错误。这时候，十有八九是驱动层在“张冠李戴”，把 MariaDB 的语句（比如定义表时的 ENGINE=InnoDB）当成 MySQL 的语法来解析了。所以，盯紧驱动的来源和版本，往往比反复调整 URL 参数里的那些“小开关”要重要得多。

相关攻略

编程语言

phpstorm如何配置项目级别的环境变量（环境隔离技巧）

PhpStorm项目级环境变量仅在显式配置的运行 调试配置中生效，Terminal不读取该配置，故getenv()返回false；需通过右键运行PHP文件或启用对应环境配置才能生效。 很多开发者容易混淆一个概念：PhpStorm 的项目级环境变量，并不是通过修改系统 PATH 或全局设置来实现的。它

热心网友

05.03

编程语言

phpstorm怎么解决运行PHP脚本超时的问题（环境参数）

根本原因是PHP CLI被系统级超时机制中断，需同时调整PHP的max_execution_time（-d参数或专用php ini）、ulimit -t（临时解除CPU时间限制）及WSL systemd的DefaultLimitCPU设置。 PHPStorm 运行脚本时卡住或报 Process fi

热心网友

05.03

编程语言

怎么配置VSCode的PHP开发环境-Xdebug调试与路径映射指南

怎么配置VSCode的PHP开发环境-Xdebug调试与路径映射指南 断点死活不触发、变量面板里一片undefined、VSCode里那个断点标记还是个空心圆——遇到这些情况，先别急着怀疑人生。十有八九，问题就出在两个地方：要么是pathMappings路径没对上，要么就是你改的php ini文件，

热心网友

05.03

编程语言

如何解决PHP路由管理问题？使用Composer引入依赖轻松搞定！

如何解决PHP路由管理问题？使用Composer引入依赖轻松搞定！ 用Composer引入路由组件，这操作本身没难度。真正的“坑”往往在后面：组件装好了，路由却不生效，参数拿不到，满屏的404——问题的核心，十有八九出在入口文件的处理和服务器重写规则没对上。 为什么 composer require

热心网友

05.03

编程语言

Composer处理不同环境下的PHP版本差异

Composer不处理PHP版本差异，只校验当前执行它的PHP版本是否满足composer json约束；所谓多版本兼容，本质是明确控制“用哪个PHP执行Composer”和“按哪个版本选包”，二者必须分离。 先说核心结论：Composer本身并不负责调和PHP版本差异。它的工作很简单，就是检查当前

热心网友

05.03

热门推荐

职业与学业

摩登奶奶

教奶奶说普通话的一天 事情是这样的，自从我回了老家，奶奶就萌生了一个新念头——她想学说普通话。老人家那股子认真劲儿一上来，谁也拗不过，我自然也没能“幸免”，在她的软磨硬泡下，接下了这个“教学任务”。 可谁能想到，刚教了没几句，我就有点扛不住了。那种感觉，怎么说呢，就像一拳打在棉花上，使不上劲儿。脸上

热心网友

05.03

职业与学业

我的怪味妈妈

酸、甜、苦、辣，还有一丝咸 酸、甜、苦、辣，同时还掺着一些咸咸的味道，几种味道混合在一起……别误会，这可不是在调制什么怪味豆的配方，而是在描述一种独特的“脾气”。包含了以上味道的怪味豆，或许还能用一个“香”字来概括；但若要用一个字来形容糅合了这几种特质的脾气，那毫无疑问，就是一个“怪”字了。 究竟怎

热心网友

05.03

职业与学业

“美图”奶奶

我的“美图”奶奶 家里有位71岁的“老学生”，心态却一点儿也不老，总爱琢磨点新鲜玩意儿。这不，最近她又解锁了一项新技能。 那天下午，我正用电脑处理照片，奶奶凑过来一看，眼睛顿时亮了。她对着屏幕上美化后的效果啧啧称奇，好奇地追问：“这是用了什么魔法？怎么照片一下子就精神了？”看她那副跃跃欲试的神情，我

热心网友

05.03

职业与学业

公司新年团年联欢会开场主持词

公司新年团年联欢会开场主持词 (男)尊敬的各位领导， (女)亲爱的各位来宾， (男)各位朋友： (合)大家晚上好！ (男)爆竹声声，传递着春的讯息；桃符处处，焕发出岁时的崭新气象。 (女)春风舞动门前的杨柳，喜雨催开满园的繁花。 (男)就在这辞别旧岁、迎接新春的美好时刻，我们欢聚一堂，共同拉开XX公

热心网友

05.03

职业与学业

说说我的奶奶

奶奶，一个多么熟悉、多么亲切的名字啊！ 提起奶奶，你脑海中会浮现出怎样的形象？是慈祥的笑容，还是忙碌的背影？我记忆里的奶奶，脸上刻满了岁月的痕迹，中等身材，一双眼睛虽不大，却总是闪着炯炯有神的光。高高的鼻梁上架着一副老花镜，配上那身再普通不过的衣裳，整个人透着一股子朴实无华的气息。 勤劳，是刻在她骨

热心网友

05.03