如何配置Doctrine避免自动为关联字段创建索引？

问题背景 #

你的实体代码如下：

<?php

namespace App\Entity\Creator;

use App\Repository\Creator\ActivityContactRepository;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity(repositoryClass: ActivityContactRepository::class)]
#[ORM\Index(columns: ['contact_id'])]
class ActivityContact
{
    #[ORM\Id]
    #[ORM\ManyToOne(targetEntity: Activity::class, cascade: ['persist'])]
    private Activity $activity;

    #[ORM\Id]
    #[ORM\Column(name: 'contact_id', type: 'integer')]
    private int $contactId;

    public function __construct(Activity $activity, int $contactId)
    {
        $this->activity = $activity;
        $this->contactId = $contactId;
    }

    public function getActivity(): Activity
    {
        return $this->activity;
    }

    public function setActivity(Activity $activity): void
    {
        $this->activity = $activity;
    }

    public function getContactId(): int
    {
        return $this->contactId;
    }
}

生成diff迁移时，Doctrine会自动为activity_id列创建索引，但该索引属于冗余项，希望通过配置直接阻止其生成，无需手动修改迁移代码。

可行解决方案 #

1. 给ManyToOne关联添加index: false参数 #

在activity属性的ManyToOne注解中显式设置index: false，禁用Doctrine为该外键列自动创建索引的默认行为：

#[ORM\Id]
#[ORM\ManyToOne(targetEntity: Activity::class, cascade: ['persist'], index: false)]
private Activity $activity;

该参数从Doctrine ORM 2.10版本开始支持，直接覆盖默认的索引生成逻辑。

2. 理解复合主键的索引逻辑 #

你的实体使用activity关联+contactId字段作为复合主键，数据库会自动为复合主键创建联合索引（包含activity_id和contact_id），这个联合索引已经能满足基于activity_id的查询需求，单独的activity_id索引完全冗余。

3. 验证修改效果 #

修改实体注解后，重新执行迁移生成命令：

php bin/console make:migration

查看新生成的迁移文件，将不会出现创建activity_id索引的语句。

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