单表继承映射下Upload类多对一关联配置问题求助

你的核心问题出在两个关键的Doctrine映射错误上：

1. 父类注解冲突：抽象Upload类同时标注了@ORM\MappedSuperclass()和@ORM\Entity()，这在Doctrine中是不允许的——单表继承的父类必须是实体（Entity），不能是映射超类（MappedSuperclass）。
2. 同列名映射矛盾：你在父类定义了$foreignId属性，然后在子类中分别将其映射为普通整数列（@ORM\Column）和多对一关联（@ORM\ManyToOne）。由于单表继承共享同一张数据库表，同一个字段不能被同时映射为两种不同的类型，Doctrine无法处理这种冲突。

我们可以通过重构实体结构解决这些问题，同时保留抽象类的方法复用能力：

1. 修正抽象父类的结构与注解 #

首先移除冲突的@ORM\MappedSuperclass()注解，调整Upload类的属性和方法，用抽象方法强制子类实现关联逻辑：

<?php namespace AppBundle\Entity\Upload;
use Doctrine\ORM\Event\LifecycleEventArgs;
use Doctrine\ORM\Mapping as ORM;
use AppBundle\Util\Registry;
use Symfony\Component\HttpFoundation\File\UploadedFile;

/**
 * Abstract Class Upload
 *
 * @package AppBundle\Entity\Upload
 *
 * @ORM\Entity(repositoryClass="AppBundle\Repository\Upload\UploadRepository")
 * @ORM\HasLifecycleCallbacks()
 * @ORM\Table(name="upload", indexes={
 *     @ORM\Index(name="idx_cat_id", columns={"category","foreign_id"})
 * })
 * @ORM\InheritanceType("SINGLE_TABLE")
 * @ORM\DiscriminatorColumn(name="category", type="string")
 * @ORM\DiscriminatorMap({
 *     "company-pic" = "UploadCompanyPic", 
 *     "user-pic" = "UploadUserPic", 
 *     "company-logo" = "UploadCompanyLogo", 
 *     "post-file" = "UploadPostFile"
 * })
 */
abstract class Upload {
    /**
     * @ORM\Id
     * @ORM\GeneratedValue(strategy="AUTO")
     * @ORM\Column(name="id", type="integer", nullable=false)
     */
    protected $id;

    // 移除父类中的$foreignId属性，由子类各自定义关联

    // 定义抽象方法，强制子类实现关联的获取和设置
    abstract public function getForeignId();
    abstract public function setForeignId($entity);

    // 保留你原来的其他通用方法（文件上传、生命周期回调等）
}

2. 重构一对一关联子类（以UploadCompanyPic为例） #

对于一对一关联的子类，定义对应的实体关联，并实现抽象方法：

<?php namespace AppBundle\Entity\Upload;
use Doctrine\ORM\Mapping as ORM;
use AppBundle\Entity\Company; // 替换为你的Company实体路径

/**
 * @ORM\Entity
 */
class UploadCompanyPic extends Upload {
    protected $category = "company-pic";

    /**
     * @ORM\ManyToOne(targetEntity="AppBundle\Entity\Company")
     * @ORM\JoinColumn(name="foreign_id", referencedColumnName="id", nullable=false)
     */
    private $company;

    public function getForeignId() {
        return $this->company ? $this->company->getId() : null;
    }

    public function setForeignId(Company $company) {
        $this->company = $company;
    }

    // 可选：添加直接操作关联实体的方法，方便业务逻辑使用
    public function getCompany(): ?Company {
        return $this->company;
    }

    public function setCompany(Company $company): self {
        $this->company = $company;
        return $this;
    }
}

UploadCompanyLogo和UploadUserPic的实现逻辑完全一致，只需替换对应的关联实体（比如User）。

3. 重构多对一关联的UploadPostFile子类 #

定义正确的多对一关联，并实现抽象方法：

<?php namespace AppBundle\Entity\Upload;
use AppBundle\Entity\Blog\Post;
use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 */
class UploadPostFile extends Upload {
    protected $category = "post-file";

    /**
     * @ORM\ManyToOne(targetEntity="AppBundle\Entity\Blog\Post", inversedBy="files")
     * @ORM\JoinColumn(name="foreign_id", referencedColumnName="id", nullable=false)
     */
    private $post;

    public function getForeignId() {
        return $this->post ? $this->post->getId() : null;
    }

    public function setForeignId(Post $post) {
        $this->post = $post;
    }

    // 可选：添加直接操作Post实体的方法
    public function getPost(): ?Post {
        return $this->post;
    }

    public function setPost(Post $post): self {
        $this->post = $post;
        return $this;
    }
}

4. 完善Post实体的反向关联 #

确保Post实体中维护好反向关联，保证多对一关系正常工作：

<?php namespace AppBundle\Entity\Blog;
use AppBundle\Entity\Upload\UploadPostFile;
use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 */
class Post {
    // ... 其他属性和方法

    /**
     * @ORM\OneToMany(targetEntity="AppBundle\Entity\Upload\UploadPostFile", mappedBy="post", cascade={"persist", "remove"})
     */
    private $files;

    public function __construct() {
        $this->files = new ArrayCollection();
    }

    public function getFiles(): ArrayCollection {
        return $this->files;
    }

    public function addFile(UploadPostFile $file): self {
        if (!$this->files->contains($file)) {
            $this->files[] = $file;
            $file->setPost($this);
        }
        return $this;
    }

    public function removeFile(UploadPostFile $file): self {
        if ($this->files->removeElement($file)) {
            if ($file->getPost() === $this) {
                $file->setPost(null);
            }
        }
        return $this;
    }
}

• 避免映射冲突：每个子类通过独立的关联属性（$company、$user、$post）映射到foreign_id列，Doctrine会自动处理ID存储，不会产生冲突。
• 保证复用性：父类的抽象方法强制子类实现关联逻辑，同时你可以在父类中继续复用所有通用的文件上传、生命周期回调等方法。
• 合法的单表继承：移除@ORM\MappedSuperclass()后，父类成为合法的Entity，Doctrine可以正确处理单表继承关系。

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