Symfony实体迁移为Attribute后出现Table属性重复错误求助

错误说明 #

将项目实体从注解（Annotations）改为PHP属性（Attribute）后，Symfony项目抛出错误：「属性“Doctrine\ORM\Mapping\Table”不可重复」

排查及解决步骤 #

1. 检查实体类的重复定义 #

这是最常见的触发原因：

• 实体类中同时保留了旧的@Table注解和新的#[Table]属性，Doctrine会同时识别两种元数据导致冲突
• 实体类中不小心重复添加了#[Table]属性

错误示例：

<?php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Table(name="products") // 未删除的旧注解
 */
#[ORM\Entity]
#[ORM\Table(name="products")] // 新属性
class Product
{
    // ...
}

修正后写法：

<?php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
#[ORM\Table(name="products")]
class Product
{
    // ...
}

2. 清理Symfony缓存 #

缓存中可能残留了旧的注解元数据，导致冲突：

# 开发环境
php bin/console cache:clear --env=dev

# 生产环境
php bin/console cache:clear --env=prod

3. 验证Doctrine配置无冲突 #

检查config/packages/doctrine.yaml配置：

• 确保mappings下的App映射类型为attribute，没有同时启用annotation类型
• 确认没有其他额外的映射配置导致元数据重复读取

4. 更新Doctrine依赖（可选） #

若以上步骤无效，可能是依赖版本兼容性问题，尝试升级到兼容的稳定版本：

composer update doctrine/orm doctrine/doctrine-bundle

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