Doctrine迁移忽略UniqueConstraint问题（Symfony 7.3 + Doctrine 2 + PostgreSQL）

我太懂你现在的烦躁了——明明照着文档试了好几种UniqueConstraint注解写法，清了缓存又清缓存，可执行make:migration时生成的迁移文件就是没出现创建联合唯一索引的SQL，简直摸不着头脑。别着急，咱们一步步排查解决：

首先，先明确核心问题：注解写法的坑 #

Doctrine的UniqueConstraint注解里，columns和fields是完全不同的概念：

• columns对应的是数据库表的实际列名（比如你的app_id、user_id）
• fields对应的是实体类里的属性名（比如appId、user）

但这里要注意：关联属性（比如$user）不能直接用在fields里，因为Doctrine无法自动把关联对象映射到对应的外键列名，所以必须用columns指定数据库的实际外键列user_id。

正确的实体注解写法 #

直接在#[ORM\Table]里定义唯一约束是最稳妥的：

declare(strict_types=1);

namespace App\Entity;

use App\Repository\UserMobileAppRepository;
use Doctrine\DBAL\Types\Types;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity(repositoryClass: UserMobileAppRepository::class)]
#[ORM\Table(
    name: '`user_mobile_apps`',
    uniqueConstraints: [
        new ORM\UniqueConstraint(
            name: 'uniq_app_user',
            columns: ['app_id', 'user_id'] // 这里必须用数据库列名！
        )
    ]
)]
class UserMobileApp {
    use BlameableTimestampableTrait;

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

    #[ORM\Column(name: "app_id", type: Types::BIGINT)]
    private ?int $appId = null;

    // ... 其他属性和方法

    #[ORM\ManyToOne(inversedBy: 'userMobileApp')]
    #[ORM\JoinColumn(name: "user_id", nullable: false)]
    private ?User $user = null;

    // ... 其他getter/setter方法
}

接下来，彻底清理缓存（关键！） #

有时候Doctrine会缓存旧的元数据，导致新的注解不生效，一定要执行全套缓存清理命令：

# 清理Doctrine元数据缓存
php bin/console doctrine:cache:clear-metadata
# 清理Symfony所有缓存（不预热）
php bin/console cache:clear --no-warmup
# 重新预热缓存
php bin/console cache:warmup

验证Doctrine是否识别到了约束 #

在生成迁移前，先确认Doctrine已经读取到了新的唯一约束：

php bin/console doctrine:mapping:info

查看输出里的UserMobileApp实体，确认包含uniq_app_user这个唯一约束。

另外，也可以直接对比映射和数据库的差异：

php bin/console doctrine:schema:update --dump-sql

如果输出里有CREATE UNIQUE INDEX uniq_app_user ON user_mobile_apps (app_id, user_id);这类语句，说明映射已经正确，只是make:migration可能没捕捉到，这时候可以手动把这段SQL加到生成的迁移文件里，或者重新执行make:migration。

额外提醒：别混淆UniqueEntity和UniqueConstraint #

你之前试过的#[UniqueEntity(fields: ['appId', 'user'])]是Symfony验证层的注解，它只在保存实体时做业务逻辑校验，不会生成数据库层面的索引，所以对迁移文件没有任何影响，不需要加这个。

最后再试一次生成迁移 #

执行：

php bin/console make:migration

现在打开生成的迁移文件，应该就能看到创建唯一索引的SQL了。

内容来源于stack exchange