Doctrine删除Project触发1451外键约束错误，级联删除无效求助

问题 #

业务代码 #

$projects = $this->doctrine->getRepository(Project::class)->findBy(['deletionDate' => new DateTime('today + 364 day')]);

foreach($projects as $project){
    $project = $this->entityManager->find('App\Entity\Project', $project->getId());
    $this->entityManager->remove($project);
}
$this->entityManager->flush();

报错信息 #

An exception occurred while executing a query: SQLSTATE[23000]: Integrity constraint violation: 1451 Cannot delete or update a parent row: a foreign key constraint fails (`foo`.`entry`, CONSTRAINT `FK_2B219D70166D1F9C` FOREIGN KEY (`project_id`) REFERENCES `project` (`id`)) 

已配置的实体关联 #

class Entry
{
   /**
     * @ORM\ManyToOne(targetEntity=Project::class, inversedBy="entries")
     * @ORM\JoinColumn(name="project_id", referencedColumnName="id", onDelete="CASCADE")
     *
     * @Assert\NotBlank
    */
    public ?Project $project;
}

class Project
{
  /**
  * @ORM\OneToMany(targetEntity="Entry", mappedBy="project", cascade={"remove"})
  */
  public Collection $entries;

}

已在实体关联中配置级联删除，但删除Project时仍触发外键约束错误1451，该如何解决？

解决方案 #

原因分析 #

问题主要来自两个方面：

1. 数据库外键约束未同步：实体注解里的onDelete="CASCADE"只是Doctrine的配置，如果没同步到数据库，数据库层面的外键并没有级联删除规则，删除Project时就会触发约束报错。
2. 实体重复查询导致状态混乱：代码里先通过findBy获取Project实例，循环里又用find重新查询一次，这会让Doctrine的实体管理器对同一个实体的状态管理出现冲突，无法正确触发级联删除逻辑。

具体解决步骤 #

• 同步数据库外键约束
  执行Doctrine迁移命令，把实体注解的配置同步到数据库：

  # 生成迁移文件
  php bin/console make:migration
  # 执行迁移更新数据库结构
  php bin/console doctrine:migrations:migrate
  

  开发环境也可以直接更新schema（生产环境禁用，避免数据丢失）：

  php bin/console doctrine:schema:update --force
  

• 优化业务代码，移除重复查询
  findBy返回的实体已经被实体管理器管理，直接调用remove即可，不需要再用find重新查询：

  $projects = $this->doctrine->getRepository(Project::class)->findBy(['deletionDate' => new DateTime('today + 364 day')]);
  
  foreach($projects as $project){
      $this->entityManager->remove($project);
  }
  $this->entityManager->flush();
  

• 验证级联配置正确性
  检查Project实体的OneToMany关联，确保cascade={"remove"}配置无误；同时确认Entry实体的JoinColumn注解里onDelete="CASCADE"拼写正确，没有大小写或拼写错误。

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