在 Symfony 项目中使用 Doctrine 添加数据库索引需通过 PHP Attributes（如 #[ORM\Index]）在实体类上声明，Doctrine 自动将其纳入迁移脚本并同步至数据库；支持单列、复合及条件索引，唯一约束用 #[ORM\UniqueConstraint] 实现。
在 Symfony 项目中使用 Doctrine 添加数据库索引，核心是通过 PHP Attributes（PHP 8.0+）在实体类上声明 #[ORM\Index]，而不是写 SQL 或依赖旧式注解。Doctrine 会自动将这些索引纳入数据库迁移脚本（doctrine:migrations:diff），最终同步到表结构中。
基础单列索引写法
确保已导入命名空间，并把 #[ORM\Index] 放在 class 声明正上方：
✅ 正确示例：
use Doctrine\ORM\Mapping as ORM;
<h1>[ORM\Entity]</h1><h1>[ORM\Table(name: 'users')]</h1><h1>[ORM\Index(name: 'idx_email', columns: ['email'])] // ← 单列索引</h1><p>class User { /<em> ... </em>/ }-
columns 必须是数组：即使只有一列，也要写成
['email']，不能是'email' - name 参数可选但推荐：便于识别和后续管理（如删除索引）
- 不能放在属性或方法上：索引属于表级元数据，仅类作用域有效
复合索引与部分索引（WHERE 条件）
支持多字段组合，也支持 PostgreSQL/MySQL 的条件索引（Partial Index）：
#[ORM\Index(
name: 'idx_status_created',
columns: ['status', 'created_at'],
options: ['where' => "status IN ('pending', 'processing')"]
)]- 复合索引按列顺序影响查询效率，高频过滤字段建议靠前
-
options['where']生成的是CREATE INDEX ... WHERE ...语句，仅 PostgreSQL 和较新 MySQL 支持 - 字符串值需用单引号包裹，SQL 关键字保持大写更清晰（如
IN,=）
唯一索引与业务字段约束
用 #[ORM\UniqueConstraint] 实现唯一性保障（非普通索引）：
#[ORM\UniqueConstraint(name: 'uq_username', columns: ['username'])]
- 它和
#[ORM\Index]是并列的独立 Attribute，都放在类顶部 - 若既要加速查询又要保证唯一，通常两者都加：一个
Index+ 一个UniqueConstraint - 注意：MySQL 中
UNIQUE约束自带 B-tree 索引，无需额外加同字段的普通索引
生成迁移并应用到数据库
写完索引后，运行命令让 Doctrine 检测变更：
php bin/console doctrine:migrations:diff php bin/console doctrine:migrations:migrate
- 第一次执行
diff会生成新迁移文件，检查其中是否包含CREATE INDEX语句 - 如果已有数据且索引字段含 NULL 值，部分数据库（如 PostgreSQL）可能要求先清理或设默认值，否则迁移失败
- 上线前建议在测试库执行一遍，确认索引名不冲突、语法无误
