Doctrine 2实体关联映射问题：同一列双字段引发非空错误

这个问题我之前在项目里也踩过坑，核心原因是：当你把$refId和$ref两个字段映射到同一个数据库列REF_ID时，Doctrine会把关联字段（@ManyToOne标注的$ref）视为主导字段。当你只设置了$refId=14但$ref仍为null时，Doctrine生成INSERT语句会优先采用$ref的状态（也就是null），而你的列设置了nullable=false，所以就会抛出Column 'REF_ID' cannot be null的错误。

下面给你几个实用的规避/修复方案，按推荐程度排序：

方案1：移除单独的ID字段，用关联代理对象替代（最推荐） #

其实完全不需要单独维护$refId字段——如果只知道关联实体的ID，不想触发数据库查询加载整个实体，你可以用Doctrine的getReference()方法创建一个代理对象。这个代理对象不会触发SQL查询，只包含ID，完全能满足关联字段的要求，还能避免状态不一致的问题。

修改你的实体，只保留关联字段：

/**
 * @var Ref
 *
 * @ManyToOne(targetEntity = "Ref")
 * @JoinColumn(name = "REF_ID", referencedColumnName = "ID", nullable = false)
 */
private $ref;

// 对应的setter方法
public function setRef(Ref $ref): void {
    $this->ref = $ref;
}

持久化时用代理对象设置关联：

$entity = new Entity();
$entity->setName("Test entity");
// 创建Ref的代理对象，不会查询数据库
$refProxy = $entityManager->getReference(Ref::class, 14);
$entity->setRef($refProxy);

$entityManager->persist($entity);
$entityManager->flush();

方案2：同步两个字段的状态（保留双字段的场景） #

如果你因为业务需求必须保留$refId和$ref两个字段，那一定要在setter方法里同步它们的状态，确保Doctrine看到的两个字段值是一致的。

比如在setRefId时自动生成关联代理对象，或者在setRef时同步更新$refId：

use Doctrine\ORM\EntityManagerInterface;

class Entity {
    private $refId;
    private $ref;
    private $entityManager;

    // 通过构造函数注入EntityManager
    public function __construct(EntityManagerInterface $entityManager) {
        $this->entityManager = $entityManager;
    }

    public function setRefId(int $refId): void {
        $this->refId = $refId;
        // 同步创建关联代理
        $this->ref = $this->entityManager->getReference(Ref::class, $refId);
    }

    public function setRef(Ref $ref): void {
        $this->ref = $ref;
        // 同步更新ID字段
        $this->refId = $ref->getId();
    }
}

这样无论你设置哪个字段，另一个都会自动同步，Doctrine就不会看到不一致的状态了。

方案3：将ID字段设为只读（只用于读取场景） #

如果$refId只需要用来读取，不需要用来写入，你可以给$refId的@Column注释添加insertable=false和updatable=false，让Doctrine只通过关联字段$ref来处理数据库列的写入操作。

修改实体字段注解：

/**
 * @var integer
 *
 * @Column(name = "REF_ID", type = "integer", nullable = false, insertable=false, updatable=false)
 */
private $refId;

/**
 * @var Ref
 *
 * @ManyToOne(targetEntity = "Ref")
 * @JoinColumn(name = "REF_ID", referencedColumnName = "ID", nullable = false)
 */
private $ref;

这样设置后，当你读取实体时$refId会被正确填充，但写入/更新时Doctrine只会使用$ref的值，所以你还是需要通过设置$ref（或代理对象）来关联实体，$refId仅作为只读字段使用。

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