SpringBoot项目中MySQL索引失效的常见场景与解决方案

// JPA: 使用函数导致索引失效
@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    @Query("SELECT u FROM User u WHERE YEAR(u.createTime) = :year") // createTime索引失效
    List<User> findByCreateTimeYear(@Param("year") int year);
}
 
// MyBatis: XML中使用函数
/*
<select id="selectUsersByMonth" resultMap="userMap">
  SELECT * FROM user WHERE MONTH(birthday) = #{month} <!-- birthday索引失效 -->
</select>
*/

// JPA 正确示例：使用范围查询
@Query("SELECT u FROM User u WHERE u.createTime BETWEEN :startDate AND :endDate")
List<User> findByCreateTimeBetween(@Param("startDate") LocalDateTime startDate, 
                                   @Param("endDate") LocalDateTime endDate);

// 假设user表的varchar_code字段是VARCHAR类型，且有索引
public interface UserRepository extends JpaRepository<User, Long> {
    // 错误：传入Long类型，与VARCHAR不匹配
    User findByVarcharCode(Long code); 
}

// 正确定义Entity字段类型
@Entity
public class User {
    @Column(name = "varchar_code")
    private String varcharCode; // 使用String而非Long
}
 
// 正确使用String类型参数
User findByVarcharCode(String code);

// 假设有复合索引 (last_name, first_name)
public interface UserRepository extends JpaRepository<User, Long> {
    // 错误：跳过了最左列last_name，索引完全失效
    List<User> findByFirstName(String firstName); 
    
    // 错误：跳过了中间列first_name，只能使用last_name索引部分
    List<User> findByLastNameAndAge(String lastName, int age); 
}

// 正确使用复合索引
List<User> findByLastNameAndFirstName(String lastName, String firstName);

// JPA
List<User> findByNameLike(String name); // 传入"%张三"时索引失效
 
// MyBatis
// SELECT * FROM user WHERE name LIKE '%${suffix}' <!-- 索引失效 -->

// 正确：使用右模糊查询（索引有效）
List<User> findByNameStartingWith(String name);

// JPA
public interface UserRepository extends JpaRepository<User, Long> {
    // 假设name有索引，但email没有索引
    List<User> findByNameOrEmail(String name, String email); // 索引失效
}

-- 原生SQL解决方案
SELECT * FROM user WHERE name = 'xxx'
UNION
SELECT * FROM user WHERE email = 'xxx';

// JPA
List<User> findByNameNot(String name); // 索引可能失效
List<User> findByNameIsNotNull();     // 索引可能失效

EXPLAIN SELECT * FROM user WHERE name = 'test';

# 显示SQL语句（开发环境）
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
 
# 更详细的日志配置（生产环境慎用）
logging.level.org.hibernate.SQL=DEBUG
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE

<!-- pom.xml添加依赖 -->
<dependency>
    <groupId>p6spy</groupId>
    <artifactId>p6spy</artifactId>
    <version>3.9.1</version>
</dependency>

# application.properties配置
spring.datasource.driver-class-name=com.p6spy.engine.spy.P6SpyDriver
spring.datasource.url=jdbc:p6spy:mysql://localhost:3306/testdb