Symfony 5.4公共服务无法调用问题求助

问题核心原因 #

Symfony 4及以后版本中，AbstractController不再使用完整的服务容器，而是采用轻量服务定位器，仅预加载了报错信息中列出的14个常用服务。即使你将BaseService设为公共服务，它也不在这个定位器的白名单里，因此无法通过$this->get()获取。

第一步：修正命名空间错误 #

你的控制器中存在命名空间拼写错误：
控制器里的use App\Service\BaseService;需改为use App\Services\BaseService;（注意多了一个s，与BaseService实际的命名空间一致）。

推荐方案：构造函数注入（符合Symfony最佳实践） #

这是Symfony 4+官方推荐的依赖注入方式，无需依赖服务定位器，性能更优且代码更清晰。

1. 修改控制器代码 #

<?php

namespace classes\classBundle\Controller;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController as Controller;
use App\Services\BaseService; // 已修正命名空间

class DefaultController extends Controller
{
    private $baseService;

    // 通过构造函数注入BaseService
    public function __construct(BaseService $baseService)
    {
        $this->baseService = $baseService;
    }

    public function index()
    {
        // 直接使用注入的服务实例
        // $this->baseService->yourMethod();
        return new Response("test");
    }
}

2. 简化服务配置 #

在services.yaml中，移除App\:配置里对src/Services/的排除，让Symfony自动注册Services目录下的所有类为服务：

services:
    _defaults:
        autowire: true
        autoconfigure: true

    App\:
        resource: '../src/'
        exclude:
            - '../src/DependencyInjection/'
            - '../src/Entity/'
            - '../src/Kernel.php'
            # 删除这一行：- '../src/Services/'
    
    classes\:
        resource: '../bundles/classes'

    # 可以删除手动定义的BaseService条目，因为自动注册已经生效
    # BaseService:
    #     class: App\Services\BaseService
    #     public: true

兼容旧代码方案（不推荐） #

如果必须保留$this->get()的写法，可以将BaseService添加到控制器的服务定位器中：
在services.yaml中添加控制器的自定义配置：

classes\classBundle\Controller\DefaultController:
    arguments:
        $locator: !service_locator
            # 保留默认服务 + 添加BaseService
            doctrine: '@doctrine'
            form.factory: '@form.factory'
            http_kernel: '@http_kernel'
            message_bus: '@message_bus'
            messenger.default_bus: '@messenger.default_bus'
            parameter_bag: '@parameter_bag'
            request_stack: '@request_stack'
            router: '@router'
            security.authorization_checker: '@security.authorization_checker'
            security.csrf.token_manager: '@security.csrf.token_manager'
            security.token_storage: '@security.token_storage'
            serializer: '@serializer'
            session: '@session'
            twig: '@twig'
            BaseService: '@BaseService'

这样修改后，你就可以继续使用$this->get("BaseService")调用服务，但这种方式会增加定位器体积，不符合Symfony的性能优化方向。

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