Symfony3.4 为实现同一接口的所有类打标签后多实现类无法识别问题

问题核心原因 #

你当前的故障是由CompilerPass里的错误前置判断导致的：
if (!$container->has(MyCustomInterface::class)) 这个判断逻辑完全不符合预期。Symfony容器只有当某个接口仅存在唯一实现类时，才会自动将接口ID指向该实现类的服务定义；当存在多个实现类时，容器中不会存在以接口FQCN为ID的服务，这个判断会直接命中返回，自然拿不到任何打了标签的服务。
同时你完全不需要去获取接口的服务定义，registerForAutoconfiguration的作用是给所有实现了该接口的服务实现类自动打标签，标签是绑定在各个子类的服务定义上的，和接口本身无关。

修正方案 #

1. 调整CompilerPass逻辑

删掉无效的接口存在判断，直接遍历所有打了目标标签的服务，通过反射检查常量是否存在，不存在直接抛出异常：

use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
use Symfony\Component\DependencyInjection\ContainerBuilder;

class MyCustomPass implements CompilerPassInterface
{
    public function process(ContainerBuilder $container): void
    {
        // 直接获取所有打了目标标签的服务
        $taggedServices = $container->findTaggedServiceIds('my_custom_tag');
        
        foreach ($taggedServices as $serviceId => $tags) {
            $serviceDefinition = $container->getDefinition($serviceId);
            $serviceClass = $serviceDefinition->getClass();
            
            // 反射检查常量是否存在
            $reflection = new \ReflectionClass($serviceClass);
            if (!$reflection->hasConstant('MY_CONST')) {
                throw new \LogicException(sprintf(
                    '类 %s 必须定义常量 MY_CONST',
                    $serviceClass
                ));
            }
        }
    }
}

2. 确认服务开启自动配置

确保所有实现MyCustomInterface的子类服务在services.yml中开启了自动配置，否则自动打标签不会生效：

services:
    App\YourNamespace\:
        resource: '../src/YourNamespace/*'
        autoconfigure: true # 必须开启才能触发registerForAutoconfiguration的规则

额外说明 #

不需要让抽象类实现该接口，保持子类单独实现即可，避免抽象类本身被容器扫描到加入校验逻辑。

内容的提问来源于stack exchange，提问作者Astro-Otter