Docker中Symfony应用PHPUnit无法断言RuntimeException问题

1. 命名空间不匹配 #

这是最常见的原因：如果测试类位于自定义命名空间（比如App\Tests），且未显式导入全局命名空间的RuntimeException，那么RuntimeException::class会指向当前命名空间下的类，而非实际抛出的全局\RuntimeException，导致PHPUnit无法匹配异常类型。

解决办法：

• 方式一：使用完全限定类名指定异常

public function testInvalidPostId(): void
{
    $this->expectException(\RuntimeException::class);
    $this->expectExceptionMessage(ExceptionMessageEnum::POST_NOT_FOUND);
    $this->getDeletePostRequest('123-456-789');
}

• 方式二：在测试类顶部导入全局异常

use RuntimeException;

class YourTestClass extends WebTestCase
{
    public function testInvalidPostId(): void
    {
        $this->expectException(RuntimeException::class);
        $this->expectExceptionMessage(ExceptionMessageEnum::POST_NOT_FOUND);
        $this->getDeletePostRequest('123-456-789');
    }
}

2. Symfony集成测试中异常被内核拦截 #

如果这是基于WebTestCase的HTTP集成测试，getDeletePostRequest可能是通过客户端发起请求（比如$client->request('DELETE', ...)）。此时Symfony的异常处理中间件会捕获RuntimeException，将其转换为HTTP错误响应（如500状态码），不会让异常冒泡到测试方法中，导致expectException无法捕获。

而旧版本PHPUnit的@expectedException注解可能存在不同的检测逻辑，或者你之前的注解测试并未真正发起HTTP请求。

解决办法：
针对HTTP请求类的集成测试，应断言响应的状态码或内容，而非直接捕获异常：

public function testInvalidPostId(): void
{
    $client = static::createClient();
    $client->request('DELETE', '/posts/123-456-789');
    
    // 断言响应状态码（根据你的异常配置调整）
    $this->assertEquals(500, $client->getResponse()->getStatusCode());
    // 断言响应内容包含异常消息
    $this->assertStringContainsString(ExceptionMessageEnum::POST_NOT_FOUND, $client->getResponse()->getContent());
}

如果是直接调用服务类方法的测试（非HTTP请求），需确保没有中间件拦截异常，同时检查命名空间是否正确。

3. 枚举值类型或PHPUnit版本问题 #

如果ExceptionMessageEnum::POST_NOT_FOUND是PHP 8.1+的枚举，需确认它是BackedEnum并使用->value获取字符串值，否则expectExceptionMessage会匹配失败（虽然你的错误提示是未捕获异常类型，但也可能间接影响）。另外，旧版本PHPUnit对expectException系列方法的支持可能存在兼容性问题。

解决办法：

• 修正枚举值的调用方式：

$this->expectExceptionMessage(ExceptionMessageEnum::POST_NOT_FOUND->value);

• 升级PHPUnit到稳定版本（如PHPUnit 9或10），确保方法行为一致。

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