Symfony 7.1中Doctrine自动映射弃用警告未消除求助

问题背景 #

我正在开发Symfony 7.1项目，更新后遇到以下弃用警告：
Since doctrine/doctrine-bundle 2.13: Enabling the controller resolver automapping feature has been deprecated. Symfony Mapped Route Parameters should be used as replacement.

已按照官方文档将控制器参数改为#[MapEntity(id: 'id')]注解形式（示例代码见下文），但警告仍未消失。现咨询两个问题：

1. 是否我对解决方案存在误解？
2. 有没有办法定位触发弃用警告的具体位置？

当前警告无明确触发点，调用栈如下：

Since doctrine/doctrine-bundle 2.13: Enabling the controller resolver automapping feature has been deprecated. Symfony Mapped Route Parameters should be used as replacement.
Hide context Hide trace
[▼
  "exception" => 
Symfony\Component\ErrorHandler\Exception
\
SilencedErrorContext {#1665 ▶}
]
{▼
  
C:\wamp64\www\natheo\vendor
\doctrine\doctrine-bundle\
src\DependencyInjection\DoctrineExtension.php:533 {▼
    
Doctrine\Bundle\DoctrineBundle\DependencyInjection
\
DoctrineExtension->ormLoad(array $config, ContainerBuilder $container) …
    › if ($config['controller_resolver']['auto_mapping'] === true) {
    ›     trigger_deprecation('doctrine/doctrine-bundle', '2.13', 'Enabling the controller resolver automapping feature has been deprecated. Symfony Mapped Route Parameters should be used as replacement.');
    › }
  }
  
C:\wamp64\www\natheo\vendor
\doctrine\doctrine-bundle\
src\DependencyInjection\DoctrineExtension.php:121 {▼
    › 
    ›     $this->ormLoad($config['orm'], $container);
    › }
  }
}

修改后的控制器示例：

#[Route('/change-password/update/{id}', name: 'change_password_update_user', methods: ['POST'])]
public function updatePassword(
    #[MapEntity(id: 'id')] User $user,
    UserService                 $userService,
    Request                     $request,
    TranslatorInterface         $translator
): JsonResponse

#[Route('/ajax/send-demo-mail/{id}', name: 'send_demo_mail', methods: ['GET'])]
public function sendDemoMail(
    #[MapEntity(id: 'id')] Mail $mail,
    MailService                 $mailService,
    OptionSystemService         $optionSystemService,
    TranslatorInterface         $translator
): JsonResponse

#[Route('/ajax/update-disabled/{id}', name: 'update_disabled', methods: ['PUT'])]
public function updateDisabled(
    #[MapEntity(id: 'id')] Tag $tag,
    TagService                 $tagService,
    TranslatorInterface        $translator,
    Request                    $request
): JsonResponse

问题解答 #

1. 对解决方案的误解澄清 #

你在控制器层面的参数映射替换是正确的，但警告的根源并非代码写法，而是Doctrine Bundle的配置问题。

从调用栈可以看到，警告在容器构建阶段触发，对应DoctrineExtension.php中判断$config['controller_resolver']['auto_mapping'] === true的逻辑——这说明你的项目配置里仍开启了Doctrine的控制器自动映射功能，即便改用了Symfony原生的#[MapEntity]注解，旧配置依旧生效，所以警告不会消失。

2. 定位并解决触发点 #

步骤1：找到目标配置文件

检查以下路径的配置：

• config/packages/doctrine.yaml（或doctrine.yml）
• 环境特定配置，比如config/packages/prod/doctrine.yaml
• 项目中导入的其他Doctrine配置文件

步骤2：关闭自动映射配置

在Doctrine配置的orm节点下，找到controller_resolver配置块，将auto_mapping设为false，或直接删除整个controller_resolver节点（默认值即为false）。

示例修改后的doctrine.yaml片段：

doctrine:
    orm:
        # 其他ORM配置...
        controller_resolver:
            auto_mapping: false

步骤3：验证配置是否生效

如果修改后警告仍存在，可通过以下命令查看Doctrine的完整配置：

php bin/console debug:config doctrine orm

在输出中找到controller_resolver.auto_mapping项，确认其值已变为false。

额外说明 #

Symfony原生的#[MapEntity]注解（Symfony 6.2+支持）已完全替代Doctrine Bundle的自动映射功能，关闭旧配置后，你现有的控制器代码无需额外修改，#[MapEntity(id: 'id')]的写法是正确的。

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