Symfony+Doctrine中如何解决‘Column not found’数据库错误？

问题背景 #

原本Gut实体的reaction字段为字符串类型，模板中硬编码选项。新增Reaction实体并将Gut表单的reaction改为EntityType后，执行gutRepository->findBy()时触发错误：

SQLSTATE[42S22]: Column not found: 1054 Unknown column 't0.reaction' in 'field list'

已手动修改MySQL的gut表，将reaction列替换为reaction_id并创建外键，同时重写了Gut和Reaction实体，但报错依旧。

相关代码 #

控制器方法 #

#[Route('/', name: 'app_gut_index', methods: ['GET'])]
public function index(GutRepository $gutRepository): Response
{
    $guts = $gutRepository->findBy([], ['happened' => 'DESC']); // 报错位置
    
    return $this->render('gut/index.html.twig', [
                'guts' => $guts,
    ]);
}

Gut实体 #

#[ORM\Id]
#[ORM\GeneratedValue]
#[ORM\Column]
private ?int $id = null;

#[ORM\Column(length: 255)] // 错误所在
#[ORM\ManyToOne(targetEntity: Reaction::class)]
#[ORM\JoinColumn(name: 'reaction_id', referencedColumnName: 'id')]
protected $reaction;

#[ORM\Column(length: 255, nullable: true)]
private ?string $description = null;

#[ORM\Column(name: "datetime")]
private ?\DateTime $happened = null;

public function getId(): ?int
{
    return $this->id;
}

public function getReaction(): ?Reaction
{
    return $this->reaction;
}

public function setReaction(?Reaction $reaction): self
{
    $this->reaction = $reaction;

    return $this;
}
...
}

Reaction实体 #

use App\Entity\Gut;
use App\Repository\ReactionRepository;
use Doctrine\ORM\Mapping as ORM;
use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;

#[ORM\Entity(repositoryClass: ReactionRepository::class)]
class Reaction
{

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

    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    private ?int $id = null;

    #[ORM\Column(length: 45)]
    private ?string $reaction = null;

    public function getId(): ?int
    {
        return $this->id;
    }

    public function getReaction(): ?string
    {
        return $this->reaction;
    }

    public function setReaction(string $reaction): self
    {
        $this->reaction = $reaction;

        return $this;
    }

    #[ORM\OneToMany(targetEntity: Gut::class, mappedBy: 'reaction')]
    private $guts;

    /**
     * @return Collection|Product[]
     */
    public function getGuts(): Collection
    {
        return $this->guts;
    }

    public function addGut($gut): self
    {
        $this->guts[] = $gut;

        return $this;
    }

    public function __toString()
    {
        return $this->getReaction();
    }

}

问题根源 #

Gut实体的reaction字段同时标注了#[ORM\Column]和#[ORM\ManyToOne]，二者存在冲突：

• #[ORM\Column]指示Doctrine将其视为普通数据库列（对应原本的字符串字段）
• #[ORM\ManyToOne]表明这是关联字段，对应数据库的外键列reaction_id

Doctrine会优先处理#[ORM\Column]的配置，尝试查询t0.reaction列，但该列已被手动替换为reaction_id，因此触发找不到列的错误。

解决方案 #

1. 移除Gut实体中reaction字段的#[ORM\Column]注解，仅保留关联相关注解：

// 修正后的Gut实体reaction字段
#[ORM\ManyToOne(targetEntity: Reaction::class)]
#[ORM\JoinColumn(name: 'reaction_id', referencedColumnName: 'id', nullable: false)] // 可根据业务需求调整nullable属性
protected $reaction;

2. 清理Doctrine元数据缓存，确保实体配置更新生效：
   执行以下命令：

php bin/console doctrine:cache:clear-metadata
php bin/console cache:clear

3. 验证实体映射正确性（可选）：
   执行命令检查映射是否存在其他错误：

php bin/console doctrine:schema:validate

修改后，Doctrine会正确识别reaction为关联字段，查询时将使用reaction_id列，报错即可解决。

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