如何注入实现同一接口的服务组，无需手动配置依赖？

你的问题核心在于：当多个服务实现同一个接口时，Symfony无法直接将它们作为集合注入——因为接口本身不是一个可实例化的服务，而ServiceSubscriberInterface默认只会尝试查找单个匹配的服务。下面是一套优雅的解决方案，不需要直接注入容器：

步骤1：创建Compiler Pass收集所有Handler服务 #

我们需要通过编译器传递，自动收集所有带标签的ItemHandlerInterface实现，然后把它们注入到一个统一的集合服务中。

首先创建编译器传递类：

// src/DependencyInjection/ItemHandlersCompilerPass.php
namespace App\DependencyInjection;

use App\Service\ItemHandlerCollection;
use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
use Symfony\Component\DependencyInjection\ContainerBuilder;
use Symfony\Component\DependencyInjection\Reference;
use Symfony\Component\DependencyInjection\ServiceLocator;

class ItemHandlersCompilerPass implements CompilerPassInterface
{
    public const ITEM_HANDLER_TAG = 'app.item_handler';

    public function process(ContainerBuilder $container)
    {
        if (!$container->has(ItemHandlerCollection::class)) {
            return;
        }

        $collectionDef = $container->findDefinition(ItemHandlerCollection::class);
        $taggedHandlers = $container->findTaggedServiceIds(self::ITEM_HANDLER_TAG);

        $handlerMap = [];
        foreach ($taggedHandlers as $serviceId => $tags) {
            // 从标签属性取handler名称，默认用服务ID（可根据需求修改）
            $handlerName = $tags[0]['handler_name'] ?? substr($serviceId, strrpos($serviceId, '\\') + 1);
            $handlerMap[$handlerName] = new Reference($serviceId);
        }

        // 将handler集合注入到ServiceLocator
        $collectionDef->setArgument(0, new ServiceLocator($handlerMap));
    }
}

接着创建集合类封装Handler的获取逻辑：

// src/Service/ItemHandlerCollection.php
namespace App\Service;

use App\Model\ItemHandlerInterface;
use Psr\Container\ContainerInterface;

class ItemHandlerCollection
{
    private ContainerInterface $locator;

    public function __construct(ContainerInterface $locator)
    {
        $this->locator = $locator;
    }

    public function get(string $handlerName): ItemHandlerInterface
    {
        if (!$this->locator->has($handlerName)) {
            throw new \InvalidArgumentException(sprintf('Handler "%s" does not exist.', $handlerName));
        }

        return $this->locator->get($handlerName);
    }

    public function has(string $handlerName): bool
    {
        return $this->locator->has($handlerName);
    }
}

步骤2：注册Compiler Pass到Kernel #

修改Kernel.php，让编译器传递生效：

// src/Kernel.php
namespace App;

use App\DependencyInjection\ItemHandlersCompilerPass;
use Symfony\Component\HttpKernel\Kernel as BaseKernel;
use Symfony\Component\DependencyInjection\ContainerBuilder;

class Kernel extends BaseKernel
{
    protected function build(ContainerBuilder $container)
    {
        parent::build($container);
        $container->addCompilerPass(new ItemHandlersCompilerPass());
    }
}

步骤3：调整services.yaml配置 #

确保标签和集合服务的配置正确：

# config/services.yaml
services:
    _defaults:
        autowire: true
        autoconfigure: true
        public: false

    # 注册Handler集合服务
    App\Service\ItemHandlerCollection: ~

    # 自动为所有ItemHandlerInterface实现打标签
    _instanceof:
        App\Model\ItemHandlerInterface:
            tags:
                - { name: !php/const App\DependencyInjection\ItemHandlersCompilerPass::ITEM_HANDLER_TAG }
            lazy: true

    # 自动扫描Handler目录（可选，Symfony默认会扫描src/下所有类）
    App\ItemHandler\:
        resource: '../src/ItemHandler/'

如果需要为每个Handler指定自定义的handler_name，可以在单个服务配置里覆盖标签属性：

App\ItemHandler\TestHandler:
    tags:
        - { name: app.item_handler, handler_name: 'test' }

步骤4：重构控制器代码 #

现在可以直接注入ItemHandlerCollection，不需要依赖ServiceSubscriberInterface或容器：

// src/Controller/ItemUpdateController.php
namespace App\Controller;

use App\Model\Item;
use App\Service\ItemFinder;
use App\Service\ItemHandlerCollection;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\RequestStack;

class ItemUpdateController extends AbstractController
{
    private ItemHandlerCollection $handlerCollection;

    public function __construct(ItemHandlerCollection $handlerCollection)
    {
        $this->handlerCollection = $handlerCollection;
    }

    public function __invoke(
        string $id,
        RequestStack $requestStack,
        ItemFinder $itemFinder
    ): Item
    {
        $item = $itemFinder->findById($id);
        $handlerName = $item->getHandlerName();

        if (!$this->handlerCollection->has($handlerName)) {
            throw new \InvalidArgumentException(sprintf('No handler found for item type "%s"', $handlerName));
        }

        $handler = $this->handlerCollection->get($handlerName);
        $request = $requestStack->getCurrentRequest();
        $payload = json_decode($request->getContent());
        
        // 假设ItemHandlerInterface定义了handle方法（如果是__invoke直接调用即可）
        $handler->handle($payload, $request);

        return $item;
    }
}

为什么原方案会报错？ #

你之前尝试通过getSubscribedServices订阅ItemHandlerInterface::class，但Symfony只会查找ID为该接口的服务——而接口本身没有被注册为服务，只有它的实现类是。当只有一个实现时，Symfony可能会自动做隐式别名，但多个实现时就无法确定要注入哪个，因此抛出"服务不存在"的错误。

这套方案通过Compiler Pass自动收集所有实现类，封装到集合中，既保持了依赖注入的优雅性，又实现了动态获取Handler的需求。

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