Symfony项目单元测试出现JWTEncodeFailureException错误求助

问题描述 #

执行单元测试时触发以下错误：

Lexik\Bundle\JWTAuthenticationBundle\Exception\JWTEncodeFailureException: Unable to create a signed JWT from the given configuration.

项目正常运行，但测试环境下报错，config/jwt目录已存在公私钥文件，且已将JWT配置同步到.env.test中。

排查与解决方案 #

1. 替换环境变量为绝对路径 #

测试环境中%kernel.project_dir%的路径解析可能出现异常，直接使用绝对路径避免解析问题：
在.env.test中添加：

###> lexik/jwt-authentication-bundle ###
JWT_SECRET_KEY=/完整项目路径/config/jwt/private.pem
JWT_PUBLIC_KEY=/完整项目路径/config/jwt/public.pem
JWT_PASSPHRASE=hellohello
###< lexik/jwt-authentication-bundle ###

2. 验证测试环境配置加载 #

在测试用例中临时添加代码，确认JWT配置是否正确加载：

// 在测试方法内添加
var_dump($_ENV['JWT_SECRET_KEY']);
var_dump(file_exists($_ENV['JWT_SECRET_KEY']));

如果路径不存在或配置未加载，检查Symfony测试环境的配置合并逻辑，确保.env中的变量能被测试环境继承。

3. 修复私钥文件权限 #

确保测试执行用户（如PHP CLI进程用户）拥有私钥文件的读取权限：

chmod 644 config/jwt/private.pem
chmod 755 config/jwt

4. 清除测试环境缓存 #

旧缓存可能导致配置未更新，执行命令清除测试环境缓存：

php bin/console cache:clear --env=test

5. Mock JWT服务（功能测试可选） #

如果测试不需要实际生成有效JWT，可以mock JWT服务跳过真实生成逻辑：

use Lexik\Bundle\JWTAuthenticationBundle\Services\JWTTokenManagerInterface;

public function testYourFeature()
{
    $jwtManager = $this->createMock(JWTTokenManagerInterface::class);
    $jwtManager->method('create')->willReturn('mock_valid_token');

    $this->getContainer()->set(JWTTokenManagerInterface::class, $jwtManager);

    // 执行测试逻辑
}

内容的提问来源于stack exchange，提问作者sigurd.thackery