Symfony 6升级至7时遭遇Doctrine元数据驱动配置错误

错误信息 #

In AbstractDoctrineExtension.php line 229:

  Can only configure "xml", "yml", "php", "staticphp" or "attribute" through the DoctrineBundle. Use your own bundle to configure other metadata drivers. You can register them by adding a new driver to the "doctrine.orm.default_metadata_driver" service definition.

问题根源 #

Symfony 7适配的DoctrineBundle版本已不再默认支持annotation类型的元数据驱动，仅保留attribute、xml、yml、php、staticphp这几种合法驱动类型。你的doctrine.yaml配置中，mappings.App.type设置为annotation，违反了新版本的配置规则。

方案1：切换到PHP属性（推荐，符合官方新规范） #

这是Doctrine ORM 3.0+和Symfony 7推荐的用法，完全替代旧的注解语法。

1. 修改doctrine.yaml中的映射配置：

doctrine:
    dbal:
        # ... 保留原DBAL配置不变
    orm:
        auto_generate_proxy_classes: true
        naming_strategy: doctrine.orm.naming_strategy.underscore_number_aware
        auto_mapping: true
        mappings:
            App:
                is_bundle: false
                type: attribute  # 将annotation替换为attribute
                dir: '%kernel.project_dir%/src/Entity'
                prefix: 'App\\Entity'
                alias: App
        dql:
            numeric_functions:
                rand: DoctrineExtensions\\Query\\Mysql\\Rand

2. 更新实体类中的注解为PHP属性语法：
   • 原注解示例：@ORM\Entity(repositoryClass=UserRepository::class)
   • 替换为属性：#[ORM\Entity(repositoryClass: UserRepository::class)]
   • 所有@ORM\XXX格式的注解都要改成#[ORM\XXX(...)]的属性形式，确保use Doctrine\ORM\Mapping as ORM;命名空间导入正常。

方案2：继续使用旧注解驱动（仅适配未改造的旧代码） #

如果暂时无法修改实体类，可以手动注册注解驱动：

1. 确保安装了Doctrine注解依赖：

composer require doctrine/annotations

2. 在config/services.yaml中注册注解驱动服务：

services:
    Doctrine\ORM\Mapping\Driver\AnnotationDriver:
        arguments:
            - '@annotation_reader'
            - '%kernel.project_dir%/src/Entity'
        tags:
            - { name: doctrine.orm.metadata_driver, driver: default }

3. 修改doctrine.yaml关闭自动映射并调整配置：

doctrine:
    dbal:
        # ... 保留原DBAL配置不变
    orm:
        auto_generate_proxy_classes: true
        naming_strategy: doctrine.orm.naming_strategy.underscore_number_aware
        auto_mapping: false  # 关闭自动映射避免冲突
        default_metadata_driver: Doctrine\ORM\Mapping\Driver\AnnotationDriver
        mappings:
            App:
                is_bundle: false
                dir: '%kernel.project_dir%/src/Entity'
                prefix: 'App\\Entity'
                alias: App
        dql:
            numeric_functions:
                rand: DoctrineExtensions\\Query\\Mysql\\Rand

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