Symfony4+PHPUnit测试RoomRepository时遇Doctrine连接异常求助

首先咱们先聚焦你遇到的Doctrine\DBAL\Exception\ConnectionException——这大概率是测试环境的数据库配置没捋顺，或者测试数据库本身不存在、权限不够。下面一步步帮你排查和解决：

1. 检查测试环境的数据库配置 #

Symfony跑测试时会自动加载config/packages/test/doctrine.yaml（如果没有就自己新建一个），你得确保这个配置指向专门的测试数据库，别和开发/生产库混着用。

举个配置示例：

# config/packages/test/doctrine.yaml
doctrine:
    dbal:
        driver: pdo_mysql
        host: '%env(TEST_DATABASE_HOST)%'
        port: '%env(TEST_DATABASE_PORT)%'
        dbname: '%env(TEST_DATABASE_NAME)%'
        user: '%env(TEST_DATABASE_USER)%'
        password: '%env(TEST_DATABASE_PASSWORD)%'
        charset: UTF8

然后在.env.test文件里配置对应的环境变量：

# .env.test
TEST_DATABASE_HOST=127.0.0.1
TEST_DATABASE_PORT=3306
TEST_DATABASE_NAME=your_app_test
TEST_DATABASE_USER=root
TEST_DATABASE_PASSWORD=your_password

⚠️ 重要提醒：测试数据库得提前创建好，你可以手动在数据库管理工具里建，也可以用Doctrine命令一键生成：

php bin/console doctrine:database:create --env=test

2. 确保测试用对了EntityManager #

写Repository测试时，别自己瞎搞连接，要从Symfony容器里拿测试环境的EntityManager。给你一个标准的测试类写法参考：

// tests/Repository/RoomRepositoryTest.php
namespace App\Tests\Repository;

use App\Entity\Room;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;

class RoomRepositoryTest extends KernelTestCase
{
    private ?EntityManagerInterface $entityManager;

    protected function setUp(): void
    {
        // 启动Symfony测试内核
        $kernel = self::bootKernel();
        $this->entityManager = $kernel->getContainer()
            ->get('doctrine')
            ->getManager();
    }

    public function testFindById(): void
    {
        // 先往测试数据库插一条测试数据（也可以用Fixture批量生成）
        $testRoom = new Room();
        $testRoom->setName('测试会议室');
        $this->entityManager->persist($testRoom);
        $this->entityManager->flush();

        // 调用Repository的方法
        $roomRepo = $this->entityManager->getRepository(Room::class);
        $foundRoom = $roomRepo->findById($testRoom->getId());

        // 断言结果符合预期
        $this->assertNotNull($foundRoom);
        $this->assertEquals('测试会议室', $foundRoom->getName());
    }

    protected function tearDown(): void
    {
        parent::tearDown();
        // 关闭EntityManager，避免内存泄漏
        $this->entityManager->close();
        $this->entityManager = null;
    }
}

3. 快速排查：换SQLite做测试数据库 #

如果折腾MySQL配置太麻烦，推荐用SQLite做测试库——它不需要提前建库，Symfony会自动生成文件，适合快速验证测试逻辑：

# config/packages/test/doctrine.yaml
doctrine:
    dbal:
        driver: pdo_sqlite
        path: '%kernel.project_dir%/var/data/test.db'

4. 用正确的命令执行测试 #

别直接调用phpunit命令，要用Symfony提供的桥接命令，它会自动加载测试环境的配置：

php bin/phpunit tests/Repository/RoomRepositoryTest.php

如果做完这些还是报错，建议把完整的错误信息贴出来（比如是找不到数据库、权限被拒还是其他原因），这样能更精准定位问题。

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