当使用 php 8+ 的 attributes（#[...]）语法定义 doctrine 实体时，若 doctrine.php 配置中 mappings 的 type 仍设为 'annotation'，会导致“entity is not a valid entity or mapped super class”错误；需将 type 显式改为 'attribute' 才能正确解析。
当使用 php 8+ 的 attributes（#[...]）语法定义 doctrine 实体时，若 doctrine.php 配置中 mappings 的 type 仍设为 'annotation'，会导致“entity is not a valid entity or mapped super class”错误；需将 type 显式改为 'attribute' 才能正确解析。
Doctrine ORM 自 2.11 起正式支持 PHP 8 Attributes（即 #[Entity]、#[Table] 等），但该支持依赖于配置中明确指定映射类型为 'attribute'。若沿用旧版注解（Annotation）配置（如 @Entity），而实际代码使用的是 Attributes，Doctrine 的元数据驱动（Metadata Driver）将无法识别实体类，从而在调用 $entityManager->getRepository(Entity::class) 时抛出 MappingException：“Entity is not a valid entity or mapped super class”。
✅ 正确配置如下（修改 doctrine.php 中的 mappings）：
'mappings' => [
'default' => [
'is_bundle' => false,
'type' => 'attribute', // ← 关键：必须为 'attribute'，而非 'annotation'
'dir' => '%kernel.project_dir%/src/Entity',
'prefix' => 'App\Entity',
'alias' => 'App'
]
]⚠️ 注意事项：
-
type => 'annotation'仅适用于 PHPDoc 风格注解（如/** @Entity */），与 Attributes 语法不兼容； - 即使项目同时存在注解和 Attributes 实体，也不能混用同一 mapping 配置；如需共存，应拆分为多个独立 mapping（例如
'entities_legacy'和'entities_modern'），并分别指定type； - 确保 Doctrine Bundle 版本 ≥ 2.9（对应 Doctrine ORM ≥ 2.11），低版本不支持 Attributes 驱动；
- 修改配置后，务必清除缓存：
php bin/console cache:clear（开发环境）或php bin/console cache:warmup（生产环境），否则变更可能不生效。
? 补充建议：
为提升可维护性，推荐在实体类中显式声明 #[ORM\Attribute]（需 use Doctrine\ORM\Mapping as ORM），并保持 repositoryClass 引用准确（如示例中 EntityRepository::class 已正确定义）。若后续升级至 Symfony 7+/Doctrine 3+，该配置方式仍完全兼容。
至此，$entityManager->getRepository(Entity::class) 将正常返回实例，实体映射与查询功能均可稳定运行。
