Java案例怎么添加数据库索引？

本文目录导读：

1. 最推荐的方式：使用数据库迁移工具
2. 在实体类中使用 JPA/Hibernate 注解
3. 在Spring Boot启动时执行SQL
4. 常见索引类型示例
5. 性能优化建议
6. 生产环境最佳实践

在Java项目中添加数据库索引,通常不是通过Java代码直接操作（虽然可以，但不推荐），而是通过数据库迁移工具或SQL脚本来完成，下面分几种常见场景说明：

最推荐的方式：使用数据库迁移工具

使用 Flyway（Java项目中最常见）

在 src/main/resources/db/migration 目录下创建SQL文件：

-- V2__add_index_to_users.sql
CREATE INDEX idx_users_email ON users(email);
CREATE INDEX idx_users_status_created ON users(status, created_at);

使用 Liquibase（另一种流行工具）

<!-- db/changelog/changelog-2.0.xml -->
<databaseChangeLog>
    <changeSet id="2" author="developer">
        <createIndex tableName="users" indexName="idx_users_email">
            <column name="email"/>
        </createIndex>
    </changeSet>
</databaseChangeLog>

在实体类中使用 JPA/Hibernate 注解

这种方式不会自动创建索引，而是用于告知Hibernate在生成DDL时创建，或用于文档/工具识别：

@Entity
@Table(name = "users", 
       indexes = {
           @Index(name = "idx_email", columnList = "email", unique = true),
           @Index(name = "idx_status_created", columnList = "status, created_at")
       })
public class User {
    @Column(name = "email")
    private String email;
    @Column(name = "status")
    private String status;
    @Column(name = "created_at")
    private LocalDateTime createdAt;
}

⚠️ 注意：这仅在 spring.jpa.hibernate.ddl-auto = update/create 时有效，生产环境通常禁用此设置。

在Spring Boot启动时执行SQL

@Component
public class DatabaseInitializer implements CommandLineRunner {
    @Autowired
    private JdbcTemplate jdbcTemplate;
    @Override
    public void run(String... args) {
        try {
            jdbcTemplate.execute("CREATE INDEX IF NOT EXISTS idx_email ON users(email)");
            jdbcTemplate.execute("CREATE INDEX IF NOT EXISTS idx_status_created ON users(status, created_at)");
        } catch (Exception e) {
            log.warn("索引可能已存在", e);
        }
    }
}

常见索引类型示例

-- 单列索引
CREATE INDEX idx_username ON users(username);
-- 复合索引（注意列的顺序）
CREATE INDEX idx_city_age ON users(city, age);
-- 唯一索引
CREATE UNIQUE INDEX idx_email_unique ON users(email);
-- 部分索引（PostgreSQL）
CREATE INDEX idx_active_users ON users(created_at) WHERE status = 'ACTIVE';
-- 全文索引（MySQL）
CREATE FULLTEXT INDEX idx_content ON articles(title, content);

性能优化建议

索引设计原则

• WHERE条件中的列：经常用于过滤的列优先
• JOIN关联的列：外键字段需要索引
• ORDER BY的列：排序字段可以加索引
• 选择性高的列：性别这种值很少的列索引效果差

避免索引的误区

-- ❌ 不要对每个列都加索引
-- ✅ 要分析慢查询，有针对性的添加
-- 查看慢查询（MySQL）
EXPLAIN SELECT * FROM users WHERE email = 'test@example.com';

生产环境最佳实践

1. 使用迁移工具（Flyway/Liquibase）管理索引变更
2. 先测试：在开发环境验证索引效果
3. 监控性能：添加索引后观察查询性能
4. 分批执行：大表添加索引时，考虑使用 CONCURRENTLY（PostgreSQL）避免锁表

-- PostgreSQL 不锁表创建索引
CREATE INDEX CONCURRENTLY idx_email ON users(email);

最佳实践：使用Flyway管理数据库变更，在SQL迁移文件中添加索引，这样可追踪、可回滚、团队协作友好。