Java案例如何实现模糊查询？

wen java案例 2026-06-07 40

Java案例如何实现模糊查询？从基础到实战的完整指南

目录导读

什么是模糊查询？为什么Java开发中必须掌握？
JDBC实现模糊查询的三种核心方式（含代码示例）
MyBatis框架中的模糊查询最佳实践（like、CONCAT、bind）
Spring Data JPA的模糊查询：Specification与@Query注解
性能优化：索引、通配符位置与SQL注入防范
实战案例：员工管理系统中的名字和部门模糊搜索
常见问题问答（FAQ）

什么是模糊查询？为什么Java开发中必须掌握？

模糊查询（Fuzzy Query）是指通过部分关键词匹配数据库中包含该关键词的记录，例如输入“张”即可查出所有姓“张”的员工，在Java Web开发中，模糊查询是搜索功能的核心，涉及SQL的LIKE关键字。

Java案例如何实现模糊查询？

重要性： 用户通常不记得完整名称，模糊查询能提升搜索体验，但如果不正确处理，容易引发SQL注入或性能低下，本文将带你从原生JDBC到主流框架，彻底掌握实现方式。

JDBC实现模糊查询的三种核心方式

方式1：字符串拼接（不推荐，有注入风险）

String keyword = "张";
String sql = "SELECT * FROM employee WHERE name LIKE '%" + keyword + "%'";

问题：若keyword包含或，会破坏SQL结构，例如输入' OR '1'='1，将爆出所有数据。

方式2：PreparedStatement占位符（推荐）

String sql = "SELECT * FROM employee WHERE name LIKE ?";
PreparedStatement ps = conn.prepareStatement(sql);
ps.setString(1, "%" + keyword + "%");
ResultSet rs = ps.executeQuery();

优点：预编译防注入，且性能更优。

方式3：使用CONCAT函数（数据库通用）

String sql = "SELECT * FROM employee WHERE name LIKE CONCAT('%', ?, '%')";

适用于MySQL,可读性更好，且兼容不同数据库方言。

MyBatis框架中的模糊查询最佳实践

使用`<bind>`标签（最推荐，灵活防注入）

<select id="searchByName" resultType="Employee">
    <bind name="pattern" value="'%' + name + '%'" />
    SELECT * FROM employee WHERE name LIKE #{pattern}
</select>

使用拼接（谨慎使用，仅用于固定值）

<select id="searchByName" resultType="Employee">
    SELECT * FROM employee WHERE name LIKE '%${name}%'
</select>

注意：直接替换字符串，不防注入，只用于参数确定安全的情况（如从枚举取值）。

直接在Java代码中拼接（最直观）

String keyword = request.getParameter("keyword");
List<Employee> list = employeeMapper.searchByName("%" + keyword + "%");

最佳实践：结合<bind>和，兼顾可读性与安全性。

Spring Data JPA的模糊查询

方式1：@Query注解 + like

@Query("SELECT e FROM Employee e WHERE e.name LIKE %:name%")
List<Employee> searchByName(@Param("name") String name);

注意：放在参数里或注解内均可，但需防止NPE。

方式2：Specification动态查询

public List<Employee> search(String keyword) {
    Specification<Employee> spec = (root, query, cb) -> {
        if (keyword == null) return null;
        return cb.like(root.get("name"), "%" + keyword + "%");
    };
    return employeeRepository.findAll(spec);
}

适合多条件组合查询。

方式3：Query By Example（QBE）

Employee example = new Employee();
example.setName("张");
ExampleMatcher matcher = ExampleMatcher.matching()
    .withStringMatcher(ExampleMatcher.StringMatcher.CONTAINING);
List<Employee> list = repository.findAll(Example.of(example, matcher));

代码最简洁,但灵活性较低。

性能优化与SQL注入防范

索引优化

模糊查询LIKE '%keyword%'无法使用索引（除非数据库支持反向索引）。
若必须为前缀查询（如'张%'），请创建INDEX(name)。
考虑使用Elasticsearch或MySQL全文索引替代LIKE。

通配符位置影响性能

'%keyword'（后缀通配）可以走索引（如果列定义合理）。
'%keyword%'（全通配）走全表扫描，大数据量时需限流或分页。

防止SQL注入

绝对禁止字符串拼接，使用（MyBatis）或setString（JDBC）。
对用户输入做白名单过滤（如去掉特殊字符、等）。

实战案例：员工管理系统的模糊搜索

需求

支持按“姓名”、“部门”任意一个字段模糊搜索，且两个条件可同时使用。

MyBatis Mapper实现

<select id="search" resultType="Employee">
    SELECT * FROM employee
    <where>
        <if test="name != null and name != ''">
            AND name LIKE CONCAT('%', #{name}, '%')
        </if>
        <if test="dept != null and dept != ''">
            AND department LIKE CONCAT('%', #{dept}, '%')
        </if>
    </where>
</select>

Service层

public List<Employee> search(String name, String dept, int page, int size) {
    // 这里可以加参数校验，如去除%符号避免用户输入恶意通配符
    name = sanitizeKeyword(name);
    dept = sanitizeKeyword(dept);
    return employeeMapper.search(name, dept, (page-1)*size, size);
}