PhpStorm连接MySQL数据库教程

本文详细讲解了在PhpStorm中成功连接MySQL数据库的五大实用方法，涵盖从基础配置、驱动加载、URL参数调优、SSH隧道搭建到用户权限排查的完整排错链路，帮助开发者快速定位并解决“Connection refused”“Driver not found”“Access denied”等常见连接失败问题，无论面对本地开发环境、远程服务器还是受安全策略限制的生产数据库，都能找到精准可行的解决方案。

如果您在PhpStorm中配置MySQL数据库连接时遇到无法建立连接的问题，则可能是由于数据库驱动未正确加载、连接参数填写错误或网络访问受限。以下是实现PhpStorm与MySQL数据库成功连接并完成连接测试的多种方法：

一、通过Database工具窗口配置MySQL连接

该方法利用PhpStorm内置的Database工具窗口，直接添加MySQL数据源并配置基础连接参数，适用于本地或远程MySQL服务已正常运行且端口可访问的场景。

1、点击PhpStorm右侧边栏的Database工具窗口（若未显示，可通过View → Tool Windows → Database打开）。

2、点击窗口左上角的+（加号）按钮，选择Data Source → MySQL。

3、在弹出的配置界面中，填写Host（如localhost或远程IP）、Port（默认3306）、Database（目标数据库名，可为空）、User和Password。

4、点击Test Connection按钮，确认状态栏显示Connection successful。

5、勾选Save password（如需），点击OK完成保存。

二、手动下载并配置MySQL JDBC驱动

当PhpStorm提示“Driver not found”或连接测试失败且日志显示ClassNotFoundException时，说明MySQL JDBC驱动（mysql-connector-java）未被识别，需手动下载并绑定驱动文件。

1、访问https://dev.mysql.com/downloads/connector/j/，下载最新版ZIP包（如mysql-connector-j-8.3.0.jar）。

2、解压后获取JAR文件，返回Database工具窗口，右键已创建的数据源，选择Properties。

3、在弹出窗口中切换至Driver选项卡，点击+（加号），选择Custom JARs，然后定位并添加下载的JAR文件。

4、在Class字段中输入com.mysql.cj.jdbc.Driver（MySQL 8.0+版本）或com.mysql.jdbc.Driver（旧版本）。

5、点击Apply后再次执行Test Connection。

三、修改JDBC URL以兼容SSL与时区设置

部分MySQL服务器启用强制SSL或存在系统时区不一致问题，导致连接被拒绝或抛出时区异常，此时需在JDBC URL中显式指定参数。

1、在Database工具窗口中，右键数据源选择Properties，进入General选项卡。

2、在JDBC URL字段末尾追加参数：?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true（如MySQL 8.0+且服务端未配置SSL证书）。

3、若需启用SSL，将useSSL=false替换为useSSL=true，并确保已配置trustCertificateKeyStoreUrl等参数。

4、点击Test Connection验证URL变更是否生效。

四、启用PhpStorm内置SSH配置连接远程MySQL

当MySQL仅允许通过跳板机（SSH隧道）访问时，需在PhpStorm中启用SSH Config配置，将本地端口转发至远程MySQL服务端口。

1、在Database数据源的SSH/SSL选项卡中，勾选Use SSH tunnel。

2、填写SSHHost（跳板机IP）、Port（通常22）、User name及认证方式（密码或密钥文件）。

3、在MySQL Host字段中填写127.0.0.1（表示跳板机本地的MySQL服务），端口保持3306。

4、确保跳板机上已运行MySQL且bind-address包含127.0.0.1或0.0.0.0，并开放对应端口。

5、点击Test Connection，PhpStorm将自动建立SSH隧道并尝试连接。

五、检查并配置MySQL用户权限与host限制

PhpStorm连接失败常因MySQL用户账户未授权从当前客户端IP访问，或权限不足导致，需登录MySQL服务端验证并调整用户权限。

1、使用命令行或已有客户端登录MySQL服务器，执行：SELECT User, Host FROM mysql.user;确认目标用户记录中的Host值是否匹配PhpStorm所在机器的IP或域名。

2、若Host为localhost，而PhpStorm通过TCP/IP连接（非socket），则需创建新用户：CREATE USER 'username'@'%' IDENTIFIED BY 'password';。

3、授予必要权限：GRANT SELECT, INSERT, UPDATE, DELETE ON database_name.* TO 'username'@'%';。

4、执行FLUSH PRIVILEGES;使权限立即生效。

5、返回PhpStorm重新测试连接，确保用户名、密码与Host策略一致。

今天关于《PhpStorm连接MySQL数据库教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！