Spring Boot电商项目如何实现按输入关键词跨多实体搜索商品功能

已发现的明显错误点 #

• 语法错误：代码中CustomResponse变量未声明类型直接赋值，正确写法应为ResponseDao CustomResponse = ResponseFactory.getResponse(request);，否则编译阶段就会报错。
• 拼写错误：ProductDAO的查询方法名findByPrductnameContains里的Prductname拼写错误，少了字母o，正确应为Productname，如果是JPA接口方法，拼写错误会直接导致查询失败。
• 返回结果遗漏：需求要求匹配Category、Tag、Subcategory、Product四类实体，但现有代码仅将Product列表塞入响应，另外三类实体的匹配结果完全没有返回，不符合业务要求。
• 空值判断逻辑缺失：
  1. 仅判断了keyword不为null，没有过滤空字符串、全空格的无效输入，这类输入会触发无意义的查询。
  2. 仅判断text != null就返回成功，但即使text是无数据的空列表也会返回成功，不符合“无匹配返回错误提示”的需求。
  3. 如果keyword为null，代码既不会进查询逻辑也不会抛异常，CustomResponse不会被设置任何状态、消息，返回给前端的是未初始化的响应对象。
• 查询逻辑隐患：
  1. 调用Product查询方法时直接传入category、tag、subcategory列表，如果这三个列表任意一个为空，JPA的IN条件会出现逻辑异常，要么返回所有商品要么返回空，完全不符合预期。
  2. 现有长名称的JPA方法无法动态忽略空查询条件，适配性极差。

修复方案 #

1. 先修正上述语法、拼写错误。
2. 定义专门的搜索结果DTO承载四类实体的匹配结果：

// 新增SearchResultDTO.java
public class SearchResultDTO {
    private List<Category> categories;
    private List<Tag> tags;
    private List<Subcategory> subcategories;
    private List<Product> products;
    // 补全getter、setter方法
}

3. 调整控制器逻辑：

public ResponseEntity<?> searchbykeyword(HttpServletRequest request, @RequestParam("keyword") String keyword) {
  logger.info("Global search function is calling !!!");
  ResponseDao CustomResponse = ResponseFactory.getResponse(request);
  try {
    // 校验无效关键词
    if(keyword == null || keyword.trim().isEmpty()) {
      CustomResponse.setResponse(null);
      CustomResponse.setStatus(CustomStatus.Error);
      CustomResponse.setStatusCode(CustomStatus.Error_CODE);
      CustomResponse.setResponseMessage("搜索关键词不能为空");
      return new ResponseEntity<>(CustomResponse, HttpStatus.BAD_REQUEST);
    }
    keyword = keyword.trim();
    System.out.println("Entered keyword is : || "+keyword);
    // 执行四类实体查询
    List<Category> category = categoryDao.findByNameContains(keyword);
    List<Tag> tag = tagDao.findByNameContains(keyword);
    List<Subcategory> subcategory = subcategoryDao.findByNameContains(keyword);
    List<Product> product = productdao.findByProductnameContainsOrDescriptivenameContainsOrFlavorContains(keyword, keyword, keyword);
    // 封装结果
    SearchResultDTO result = new SearchResultDTO();
    result.setCategories(category);
    result.setTags(tag);
    result.setSubcategories(subcategory);
    result.setProducts(product);
    // 判断是否有匹配结果
    boolean hasMatch = !category.isEmpty() || !tag.isEmpty() || !subcategory.isEmpty() || !product.isEmpty();
    if(hasMatch) {
      CustomResponse.setResponse(result);
      CustomResponse.setStatus(CustomStatus.OK);
      CustomResponse.setStatusCode(CustomStatus.OK_CODE);
      CustomResponse.setResponseMessage(CustomStatus.SuccessMsg);
    } else {
      CustomResponse.setResponse(null);
      CustomResponse.setStatus(CustomStatus.Error);
      CustomResponse.setStatusCode(CustomStatus.Error_CODE);
      CustomResponse.setResponseMessage("未找到匹配的结果");
    }
  } catch (Exception e) {
    e.printStackTrace();
    CustomResponse.setResponse(null);
    CustomResponse.setStatus(CustomStatus.Error);
    CustomResponse.setStatusCode(CustomStatus.Error_CODE);
    CustomResponse.setResponseMessage(CustomStatus.ErrorMsg);
  }
  return new ResponseEntity<>(CustomResponse, HttpStatus.OK);
}

4. 优化DAO层查询逻辑：建议改用JPA Specification或QueryDSL实现动态查询，避免硬编码的长方法名出现空列表查询逻辑异常的问题。

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