Symfony中AbstractController::$container未初始化访问错误排查

遇到AbstractController的$container属性未初始化错误，错误信息如下：

Error: Typed property Symfony\Bundle\FrameworkBundle\Controller\AbstractController::$container must not be accessed before initialization

D:\Development\omegofleet\vendor\symfony\framework-bundle\Controller\AbstractController.php:343
D:\Development\omegofleet\src\Controller\UserController.php:203
D:\Development\omegofleet\tests\UserTest.php:185

场景详情 #

• UserController继承自AbstractController，通过构造函数注入EntityManagerInterface、UserRepository、TokenStorageInterface
• 控制器的delete方法调用getUser()获取当前用户：

#[Route('/api/users/{id}', name: 'user_delete', methods: ['DELETE'])]
public function delete(User $user): Response
{
    $currentUser = $this->getUser();
    // 省略后续代码
}

• 测试类UserTest继承WebTestCase，直接通过new实例化控制器并调用方法：

public function testDeleteAsSuperAdmin(): void
{
    // 省略测试代码
    $controller = new UserController($this->entityManagerMock, $this->userRepositoryMock, $this->tokenStorageMock);
    $response = $controller->delete($user);
    // 省略断言代码
}

• AbstractController的getUser()方法会直接访问$this->container：

protected function getUser(): ?UserInterface
{
    if (!$this->container->has('security.token_storage')) {
        throw new \LogicException('The SecurityBundle is not registered in your application. Try running "composer require symfony/security-bundle".');
    }
    // 省略后续代码
}

• service.yml已配置自动注入与自动配置：

parameters:

services:
  _defaults:
    autowire: true
    autoconfigure: true

  App\:
    resource: '../src/'
    exclude:
      - '../src/DependencyInjection/'
      - '../src/Entity/'
      - '../src/Kernel.php'

• AbstractController的$container是类型化属性，默认未初始化，只有当控制器由Symfony容器负责实例化时，容器才会自动调用setContainer()方法为其赋值
• 测试中直接通过new UserController(...)手动实例化控制器，完全绕过了Symfony的容器初始化流程，导致$container属性始终未被赋值，调用依赖它的getUser()方法时触发错误

方案1：通过Symfony容器获取控制器实例（推荐） #

利用WebTestCase的容器来获取控制器，确保控制器的$container被正确初始化，同时也符合Symfony的服务管理逻辑：

public function testDeleteAsSuperAdmin(): void
{
    $client = static::createClient();
    
    // 从容器中获取控制器实例，容器会自动处理container注入
    $controller = $client->getContainer()->get(UserController::class);
    
    // 或者更贴近真实场景：直接发起HTTP请求测试
    $client->request('DELETE', '/api/users/'.$user->getId());
    
    // 执行断言
    $this->assertResponseIsSuccessful();
}

如果需要替换控制器的依赖，可以通过修改测试环境的服务配置（比如config/services_test.yaml）来注入mock实例。

方案2：手动为控制器注入容器 #

如果坚持手动实例化控制器，需要手动创建容器并注入到控制器中：

use Symfony\Component\DependencyInjection\ContainerBuilder;

public function testDeleteAsSuperAdmin(): void
{
    // 创建模拟容器
    $container = new ContainerBuilder();
    // 将mock的token_storage注册到容器中
    $container->set('security.token_storage', $this->tokenStorageMock);
    
    $controller = new UserController($this->entityManagerMock, $this->userRepositoryMock, $this->tokenStorageMock);
    // 手动调用setContainer方法注入容器
    $controller->setContainer($container);
    
    $response = $controller->delete($user);
    // 断言代码
}

此方案不推荐，因为会脱离Symfony的服务管理体系，增加测试复杂度。

方案3：重构控制器，脱离对AbstractController的container依赖 #

既然已经通过构造函数注入了TokenStorageInterface，可以直接用它来获取用户，完全避免调用getUser()：

// 在UserController的delete方法中
public function delete(User $user): Response
{
    // 直接使用注入的tokenStorage获取当前用户
    $token = $this->tokenStorage->getToken();
    $currentUser = $token ? $token->getUser() : null;
    
    // 后续业务逻辑不变
}

修改后，测试中直接实例化控制器时，只要正确mockTokenStorageInterface的返回值，就不会触发$container相关错误，同时让控制器的依赖更清晰。

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