Symfony 5.4报错：找不到类'x'的实体管理器，如何兼容注解与属性？

问题场景 #

将旧Symfony 5.4项目中使用Doctrine注解（如@ORM\Table、@ORM\Column）的实体复制到同版本新项目后，出现报错「Could not find the entity manager for class 'x'」。新项目默认使用属性映射（如#[ORM\Table]、#[ORM\Column]），改为属性格式后问题消失，但需要配置项目同时支持两种映射方式。

解决方案 #

修改config/packages/doctrine.yaml中的ORM映射配置，在App节点下添加type: attribute和enable_annotations: true，让Doctrine同时解析属性与注解格式的映射：

doctrine:
    dbal:
        url: '%env(resolve:DATABASE_URL)%'

        # IMPORTANT: You MUST configure your server version,
        # either here or in the DATABASE_URL env var (see .env file)
        #server_version: '14'
    orm:
        auto_generate_proxy_classes: true
        naming_strategy: doctrine.orm.naming_strategy.underscore_number_aware
        auto_mapping: true
        mappings:
            App:
                is_bundle: false
                dir: '%kernel.project_dir%/src/Entity'
                prefix: 'App\Entity'
                alias: App
                type: attribute
                enable_annotations: true

原理说明 #

新项目默认的Doctrine配置仅启用了属性（attribute）类型的映射解析，导致注解格式的实体无法被识别，进而触发「找不到实体管理器」的错误。通过添加上述配置，明确告知Doctrine同时支持属性和注解两种映射方式。

额外注意事项 #

• 所有实体类顶部必须保留use Doctrine\ORM\Mapping as ORM;语句，两种映射方式都依赖该命名空间别名
• 配置修改后执行php bin/console cache:clear清除缓存，确保新配置生效
• 无需为两种映射方式分开创建目录或映射节点，同一实体目录下的文件可以混用注解和属性格式

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