SpringBoot实现支持单名/全名搜索的统一搜索框问题排查

原代码的核心问题出在全名搜索的逻辑偏差，以及Controller层的错误处理，下面是具体问题和修复方案：

几个关键问题 #

1. 全名查询逻辑完全错误：原findByFullName方法是拿输入的完整全名（比如"John Doe"）去匹配firstName或lastName的包含关系，这根本找不到正确的全名匹配记录——毕竟没有员工的名或姓会是"John Doe"。
2. Controller逻辑冗余且跑偏：拆分出 firstName 和 lastName 后，循环遍历的是错误的查询结果，最后还返回所有 firstName 匹配的员工，完全不符合“返回对应全名记录”的需求。
3. 空格拆分不严谨：只用split(" ")处理空格，如果用户输入多个空格（比如"John Doe"），会拆分出空字符串，导致后续匹配失败。

修复步骤 #

1. 给Repository加精确匹配全名的方法 #

先在EmployeeRepository里新增专门匹配全名的查询，支持忽略大小写：

@Repository
public interface EmployeeRepository extends JpaRepository<Employee, Long> {
    // 保留原有模糊匹配方法
    List<Employee> findByFirstNameContainingIgnoreCaseOrLastNameContainingIgnoreCase(String firstName, String lastName);
    List<Employee> findByFirstNameContainingIgnoreCase(String firstName);
    List<Employee> findByLastNameContainingIgnoreCase(String lastName);
    
    // 新增：精确匹配名+姓（忽略大小写）
    List<Employee> findByFirstNameIgnoreCaseAndLastNameIgnoreCase(String firstName, String lastName);
}

2. 调整Service层方法 #

给EmployeeService加上对应的全名匹配方法，同时把原findByFullName重命名，明确它的实际功能（模糊匹配名或姓）：

@Service
public class EmployeeService {
    private final EmployeeRepository empRepo;

    @Autowired
    public EmployeeService(EmployeeRepository empRepo) {
        this.empRepo = empRepo;
    }

    // 重命名原方法，明确是模糊匹配名或姓
    public List<Employee> findByNameContaining(String keyword) {
        return empRepo.findByFirstNameContainingIgnoreCaseOrLastNameContainingIgnoreCase(keyword, keyword);
    }

    public List<Employee> findByFirstName(String firstName) {
        return empRepo.findByFirstNameContainingIgnoreCase(firstName);
    }

    public List<Employee> findByLastName(String lastName) {
        return empRepo.findByLastNameContainingIgnoreCase(lastName);
    }
    
    // 新增：精确匹配全名的方法
    public List<Employee> findByExactFullName(String firstName, String lastName) {
        return empRepo.findByFirstNameIgnoreCaseAndLastNameIgnoreCase(firstName, lastName);
    }
}

3. 重构Controller的搜索逻辑 #

修正逻辑，处理多空格、空输入，正确调用查询方法：

@Controller
public class EmployeeController {
    private final EmployeeService empService;

    @Autowired
    public EmployeeController(EmployeeService empService) {
        this.empService = empService;
    }

    @PostMapping("search-by-full-name")
    public String handleSearchByFullName(Model model, @RequestParam("fullName") String fullName) {
        // 先处理空输入
        String trimmedName = fullName.trim();
        if (trimmedName.isEmpty()) {
            model.addAttribute("error", "搜索内容不能为空");
            return "errorPage";
        }

        // 处理带空格的全名搜索
        if (trimmedName.contains(" ")) {
            // 按任意数量空格拆分，避免多空格坑
            String[] nameParts = trimmedName.split("\\s+");
            // 假设输入是"名 姓"格式，取前两个部分
            String firstName = nameParts[0];
            String lastName = nameParts[1];
            
            // 查精确匹配全名的员工
            List<Employee> matchedEmps = empService.findByExactFullName(firstName, lastName);
            if (!matchedEmps.isEmpty()) {
                model.addAttribute("emps", matchedEmps);
                return "showEmployees";
            }
        }

        // 如果不是全名搜索，或者全名没找到，就用模糊匹配名或姓兜底
        List<Employee> matchedEmps = empService.findByNameContaining(trimmedName);
        if (!matchedEmps.isEmpty()) {
            model.addAttribute("emps", matchedEmps);
            return "showEmployees";
        }

        // 啥都没找到，返回错误页
        model.addAttribute("error", "未找到匹配的员工记录");
        return "errorPage";
    }
}

额外说明 #

• 用split("\\s+")拆分空白字符，能处理用户输入多个空格、制表符的情况，更健壮。
• 优先精确匹配全名，再降级到模糊匹配，符合搜索的常规逻辑：用户输入全名时优先找精确匹配，输入单名/姓时找模糊匹配。
• 增加了空输入的判断，避免无效查询。

内容的提问来源于stack exchange，提问作者R4V3N