Spring Boot单元测试中Mock EntityManager是否为合理实践？

1. 这种Mock方式是否属于不良编码实践？ #

是的，这种写法确实存在明显的测试覆盖漏洞，属于不够严谨的实践：

• 你用Mockito.anyString()匹配所有传入createQuery的语句，完全不校验JPQL本身的正确性，哪怕你拼写出错、字段名写错、关联关系写错，单元测试都不会报错
• 你也没有校验参数绑定的逻辑，就算参数名和传入值不匹配，测试也不会感知
• 这种测试只能校验查询结果为空时的返回逻辑，完全覆盖不到查询本身的正确性，上线后很容易出现单元测试全过但实际接口报错的问题

2. 无需访问数据库的校验方案 #

以下几种方案都不需要连接真实的业务数据库，就可以完成查询相关逻辑的校验：

• 用Mockito精准匹配+参数校验
  不需要改现有Mock逻辑，只要把宽松的参数匹配改成精准匹配，再加参数绑定校验即可：

  // 1. 精准匹配你预期的JPQL语句，只要代码里的JPQL和预期不一致就会匹配失败
  String expectedJpql = "SELECT r.reservation_time from Reservation r left join fetch r.driverAssignment  where r.reservation_time > :reservation_time and r.reserved_status.slug in ('pending','approved') and r.reserved_vehicle.id=:vehicle_id  order by r.reservation_time asc ";
  Mockito.when(em.createQuery(Mockito.eq(expectedJpql))).thenReturn(query);
  Mockito.when(query.getResultList()).thenReturn(new LinkedList());
  
  // 执行业务方法后加校验
  Mockito.verify(query).setParameter("reservation_time", reservation_date);
  Mockito.verify(query).setParameter("vehicle_id", vehicle_id);
  

  这种方案完全不需要额外依赖，只靠Mockito就能实现，可以覆盖JPQL拼写、参数绑定两个核心逻辑的校验。

• 用Hibernate JPQL解析器做语法合法性校验
  你可以直接调用Hibernate自带的JPQL解析器，只依赖JPA实体元数据就能校验JPQL的语法、实体字段、关联关系的正确性，全程不需要连接任何数据库：

  @Test
  void validateJpqlSyntax() {
      // 拿到你实际业务代码里的JPQL语句
      String targetJpql = "SELECT r.reservation_time from Reservation r left join fetch r.driverAssignment  where r.reservation_time > :reservation_time and r.reserved_status.slug in ('pending','approved') and r.reserved_vehicle.id=:vehicle_id  order by r.reservation_time asc ";
      SessionFactoryImplementor sessionFactory = emf.unwrap(SessionFactoryImplementor.class);
      QueryTranslatorFactory translatorFactory = new ASTQueryTranslatorFactory();
      QueryTranslator translator = translatorFactory.createQueryTranslator(targetJpql, targetJpql, Collections.emptyMap(), sessionFactory);
      // 解析过程中如果有语法错误、字段不存在、关联非法等问题都会直接抛出异常
      translator.compile(Collections.emptyMap(), false);
  }
  

  这种方案可以自动校验JPQL的合法性，不需要你手写预期的JPQL字符串，适合JPQL比较复杂、改动频繁的场景。

• 轻量内存数据库方案（可选）
  如果可以接受使用内存级的临时数据库，可以用Spring Boot的@DataJpaTest注解搭配H2内存数据库，测试启动时会自动根据JPA实体创建表结构，不需要你手动维护数据库实例，执行查询速度非常快，不仅可以校验JPQL的正确性，还能验证查询逻辑的返回结果是否符合预期，比纯Mock的测试可信度更高。

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