Gitlab CI + CakePHP 3测试失败求助：数据库连接错误

问题根源分析 #

你遇到的SQLSTATE[HY000] [2002] No such file or directory错误，本质是测试容器无法连接到MySQL服务容器，主要有两个核心原因：

1. GitLab CI中Docker容器间的通信规则：localhost指向当前运行PHPUnit的容器，而非MySQL服务容器；
2. CI脚本中覆盖了你的数据库配置文件，导致本地修改的测试连接设置未生效。

分步解决方案 #

1. 修正数据库连接的主机配置

在config/app.php的测试数据源配置中，把主机默认值从localhost改为mysql（GitLab CI服务的名称）：

'test' => [
    'className' => 'Cake\Database\Connection',
    'driver' => 'Cake\Database\Driver\Mysql',
    'persistent' => false,
    'host' => env('MYSQL_HOST', 'mysql'), // 这里改成mysql
    'username' => env('MYSQL_USER', 'root'),
    'password' => env('MYSQL_ROOT_PASSWORD', 'secret'),
    'database' => env('MYSQL_DATABASE', 'test_myapp'),
    // 其他配置保持不变
],

2. 确保CI脚本不覆盖配置文件

你的CI脚本里执行了cp config/app.default.php app.php，这会把你本地修改的config/app.php覆盖成默认版本！解决方法二选一：

• 方法A：把测试数据库的配置直接写到config/app.default.php里，确保CI环境能读取到正确配置；
• 方法B：修改CI脚本，跳过复制默认文件（如果config/app.php已经提交到Git仓库，且不包含敏感信息）：

  script:
    # 去掉 cp config/app.default.php app.php 这一行
    - vendor/bin/phpunit
  

  注意：如果config/app.php包含敏感信息（比如密码），不要提交到Git，改用环境变量完全接管配置。

3. 在CI变量中明确MySQL连接参数

更新.gitlab-ci.yml的variables部分，补充缺失的MYSQL_HOST和MYSQL_USER：

variables:
  MYSQL_DATABASE: test_myapp
  MYSQL_ROOT_PASSWORD: secret
  MYSQL_HOST: mysql # 新增这个变量
  MYSQL_USER: root # 新增这个变量

4. 添加MySQL就绪等待逻辑

MySQL容器启动可能比PHP容器慢，导致PHPUnit启动时MySQL还未就绪。在before_script末尾添加等待脚本：

before_script:
  # 原有安装步骤保持不变
  - |
    # 等待MySQL服务就绪
    until mysqladmin ping -h"$MYSQL_HOST" -u"$MYSQL_USER" -p"$MYSQL_ROOT_PASSWORD" --silent; do
      echo "Waiting for MySQL to be ready..."
      sleep 2
    done

最终验证 #

修改完成后，重新触发GitLab CI流水线，应该能成功连接到测试数据库并执行Fixture插入操作。

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