Symfony 5控制器无容器错误求助：需控制器而非服务

问题重现 #

开发Symfony 5应用时，创建的控制器触发以下异常：

未捕获的PHP异常LogicException："App\Controller\UploadFileController" has no container set, did you forget to define it as a service subscriber?
报错位置：/vendor/symfony/framework-bundle/Controller/ControllerResolver.php第36行

控制器代码：

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Routing\Annotation\Route;

class UploadFileController extends AbstractController
{
    /**
     * @Route("/test-upload", name="app_test_upload")
     */
    public function testAction(Request $request, FileUploader $fileUploader)
    {
        return 1;
    }
}

曾尝试清理缓存无效，且手动在services.yaml添加了以下配置：

services:
    App\Controller\UploadFileController:
        calls:
            - [setContainer, ['@service_container']]

解决步骤 #

1. 删除services.yaml中的手动控制器配置
   直接移除你添加的App\Controller\UploadFileController相关配置——Symfony 5默认会自动注册控制器，手动配置会干扰默认的容器注入逻辑。

2. 确认框架自动注册控制器的配置
   检查config/packages/framework.yaml中是否存在以下默认配置：

   framework:
       # 其他配置...
       controllers:
           resource: '../../src/Controller/'
           type: annotation
   

   这段配置会自动扫描src/Controller目录下带注解路由的控制器，完成服务注册和容器注入。

3. 再次清理缓存
   执行命令彻底清理缓存：

   php bin/console cache:clear
   

原因说明 #

Symfony 5+ 中，控制器通过@Route注解自动被识别并注册为服务，默认会自动注入服务容器。手动在services.yaml中定义控制器服务，会覆盖框架的默认配置，导致容器无法正确注入，从而出现"has no container set"的错误。

内容的提问来源于stack exchange，提问作者Таня