PhpStorm从Docker容器运行PHPUnit数据库测试时MySQL连接失败

看起来你遇到的问题很典型——同一容器内其他场景都能连MySQL，唯独PhpStorm通过辅助脚本跑测试时失败。先澄清一个误解：/opt/.phpstorm_helpers/phpunit.php是PhpStorm注入到你的应用容器里的辅助脚本，不是独立容器，所以不需要额外关联容器。下面是具体的排查和解决步骤：

1. 检查数据库连接的主机参数 #

很多时候问题出在localhost和127.0.0.1的区别上：

• 如果你的测试代码/PHPUnit配置里用的是localhost，尝试换成127.0.0.1。因为在容器环境中，localhost可能会尝试通过Unix socket连接MySQL，而如果容器内MySQL的socket路径没有正确配置（或者PHP扩展没指向正确路径），就会出现连接拒绝。
• 反之，如果用的是127.0.0.1，确认MySQL容器内的服务确实监听TCP的3306端口，可以在容器内执行netstat -tulpn | grep 3306验证。

2. 手动在容器内执行测试，定位问题根源 #

先排除PhpStorm的影响，直接在容器内运行测试命令：

# 进入你的应用容器
docker exec -it mycontainer bash
# 执行测试（用容器内的phpunit二进制文件，不是PhpStorm的辅助脚本）
php /var/www/myapp/vendor/bin/phpunit --configuration /var/www/myapp/tests/phpunit.xml /var/www/myapp/tests/unit

• 如果这个命令能成功运行，说明问题出在PhpStorm的运行配置上；
• 如果同样失败，那就是测试代码或PHPUnit配置的问题，重点检查数据库连接参数、MySQL服务状态。

3. 调整PhpStorm的PHPUnit运行配置 #

如果手动执行测试成功，那需要修正PhpStorm的配置：

• 检查环境变量：打开PHPUnit运行配置，在「Environment variables」里确认是否传递了正确的数据库连接变量（比如DB_HOST、DB_USER、DB_PASSWORD），有时候PhpStorm不会自动继承容器的环境变量，导致测试拿不到正确的参数。
• 切换测试运行方式：默认情况下PhpStorm会用自带的辅助脚本，你可以改成直接使用容器内的PHPUnit：
  1. 打开PHPUnit运行配置，在「Test runner」选项里选择「PHPUnit library」；
  2. 「Path to phpunit.phar」改为容器内的路径/var/www/myapp/vendor/bin/phpunit；
  3. 确保「Container」选项正确选择了你的mycontainer容器，然后重新运行测试。

4. 验证MySQL服务状态 #

虽然你说其他脚本能连接，但还是可以再确认一下容器内的MySQL是否正常运行：

docker exec mycontainer mysqladmin -u [你的用户名] -p ping

输入密码后如果返回mysqld is alive，说明服务没问题。

内容的提问来源于stack exchange，提问作者Bounce