如何用继承类替换Doctrine实体并解决SQL别名不匹配问题？

问题背景 #

在使用Doctrine ORM 2.7.0的Symfony 4应用中，需为Akeneo 5的Product实体添加stock属性，但无法直接修改原实体。通过创建继承原实体的自定义类并替换原实体类的方式实现，却出现SQL别名不匹配报错：生成的SELECT语句中列使用t1别名，WHERE条件使用t0别名。经排查，问题源于Doctrine的BasicEntityPersister处理继承字段时，原实体与自定义实体被分配了不同的SQL别名。

已实现的代码配置 #

自定义Product实体类

<?php
namespace Tpg\Bundle\AkeneoTpgBundle\Entity;

use Akeneo\Pim\Enrichment\Component\Product\Model\Product as AkeneoProduct;

class Product extends AkeneoProduct
{
    private $stock;

    // 访问方法...
}

服务参数配置（config/services/services.yml）

parameters:
  pim_catalog.entity.product.class: 'Tpg\Bundle\AkeneoTpgBundle\Entity\Product'

Doctrine映射配置（src/Tpg/Bundle/AkeneoTpgBundle/Resources/config/doctrine/Product.orm.yml）

Tpg\Bundle\AkeneoTpgBundle\Entity\Product:
  type: entity
  table: pim_catalog_product
  fields:
    stock:
      type: integer
      nullable: false

解决方案 #

1. 修正Doctrine继承映射配置 #

原映射未明确继承关系，导致Doctrine误判实体类型引发别名冲突。需在自定义实体的映射文件中添加单表继承声明：

更新Product.orm.yml：

Tpg\Bundle\AkeneoTpgBundle\Entity\Product:
  type: entity
  table: pim_catalog_product
  inheritanceType: SINGLE_TABLE
  parentEntity: Akeneo\Pim\Enrichment\Component\Product\Model\Product
  fields:
    stock:
      type: integer
      nullable: false

通过parentEntity指定父类实体，inheritanceType: SINGLE_TABLE明确使用单表继承，让Doctrine正确识别实体继承关系，统一SQL别名。

2. 清除Doctrine元数据缓存 #

旧的元数据缓存可能导致映射配置不生效，执行以下命令清除缓存：

bin/console doctrine:cache:clear-metadata

3. 确认实体管理器映射加载配置 #

确保Symfony的Doctrine配置中正确加载了自定义实体的映射文件，在config/packages/doctrine.yaml中添加或检查：

doctrine:
    orm:
        mappings:
            AkeneoTpgBundle:
                is_bundle: true
                type: yml
                dir: '%kernel.project_dir%/src/Tpg/Bundle/AkeneoTpgBundle/Resources/config/doctrine'
                prefix: 'Tpg\Bundle\AkeneoTpgBundle\Entity'
                alias: AkeneoTpgBundle

4. 排除原实体的重复映射 #

若Akeneo原Product实体的映射仍被加载，会导致Doctrine识别两个实体对应同一张表，引发别名问题。可通过配置排除原实体的映射，或确保自定义类完全替换原类后，原实体元数据不再被加载。

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