在 Hyperf 中添加数据库索引需通过 Migration 文件，使用 Schema::table() 配合 index()、unique()、fullText() 等方法，在 up() 中显式声明；应规范命名（如 idx_、uk_）、结合查询场景设计复合索引，并执行迁移及 SHOW INDEX 验证。
在 Hyperf 中添加数据库索引，主要通过 Migration（迁移）文件实现，配合 Schema::table() 和索引方法（如 index()、unique()、fulltext() 等）完成。关键在于定义清晰、命名规范、避免冗余，并兼顾查询场景与写入性能。
迁移中正确声明索引
Hyperf 使用 Laravel 风格的 Schema 构建器，索引需在 up() 方法中显式添加：
- 普通索引：
$table->index('user_id');或组合索引$table->index(['user_id', 'status']); - 唯一索引：
$table->unique('email');，多字段用数组$table->unique(['tenant_id', 'code']); - 全文索引（MySQL）：
$table->fullText('title');（需引擎支持 InnoDB/MyISAM） - 指定索引名（推荐）：
$table->index('category_id', 'idx_posts_category_id');，便于后续管理与删除
索引命名规范与可维护性
Hyperf 默认为索引生成随机名（如 posts_user_id_index），但手动指定名称更利于协作和回滚：
- 前缀统一：用
idx_（普通）、uk_（唯一）、ft_（全文）区分类型 - 字段名按顺序拼接，用下划线分隔，如
idx_orders_user_id_status_created_at - 删除索引时需用相同名称：
$table->dropIndex('idx_orders_user_id_status_created_at');
结合业务场景设计有效索引
不是所有字段都适合加索引。应围绕高频查询条件、排序字段、外键关联字段来设计：
- WHERE 条件中常出现的字段（如
status、is_deleted）建议加索引，但低区分度字段（如布尔值）慎用单列索引 - ORDER BY + LIMIT 场景，把排序字段放入复合索引最左位置，例如
SELECT * FROM logs WHERE app = ? ORDER BY created_at DESC LIMIT 20→ 建议INDEX idx_logs_app_created_at (app, created_at) - 外键字段默认应建索引，Hyperf 不自动创建，需手动补上：
$table->index('category_id');
执行与验证索引是否生效
迁移写完后，运行命令并确认结构变更：
- 执行迁移：
php bin/hyperf.php migrate（首次）或php bin/hyperf.php migrate:refresh（重置开发环境） - 检查索引是否存在：
php bin/hyperf.php db:show-tables --table=your_table_name（需安装 hyperf/db-command 组件） - 终极验证方式：在 MySQL 客户端执行
SHOW INDEX FROM your_table_name;，确认 Key_name 和 Column_name 符合预期
不复杂但容易忽略的是索引的“生命周期管理”——新增字段要补索引，废弃查询要删索引，上线前用慢查询日志和 EXPLAIN 检查执行计划。Hyperf 本身不干预索引逻辑，真正起作用的是你写的那一行 $table->index()。
