Spring Data JPA查询报错：参数值与Integer类型不匹配求助

错误根源 #

你遇到的IllegalArgumentException核心原因是LIKE操作符仅适用于字符串类型字段，但你的idExamen是Integer类型。当JPQL执行LIKE %:q%时，JPA会试图把Integer类型的参数q与字符串格式的%...%拼接，直接导致类型不匹配，触发异常。

解决方案 #

根据你的实际需求，选择以下两种方案之一：

方案1：模糊匹配数字（转为字符串处理）

如果确实需要对数字ID做模糊匹配（比如匹配ID包含某段数字），需要先把Integer类型的字段转为字符串，再执行LIKE查询：

@Repository(value = "TblagendalabRepository")
public interface TblagendalabRepository extends JpaRepository<Tblagendalab, Integer>{
     
     @Query(value = "SELECT p FROM Tblagendalab p WHERE CAST(p.tblagendalabPK.idExamen AS string) LIKE %:q%")
     List<Tblagendalab> findByExamenLab(@Param("q") String q);
}

同时修改Controller层的参数类型为String（前端传入的查询关键词通常是字符串形式）：

@GetMapping(value = "/buscar")
public String buscarExamen(Model model, @RequestParam(value = "buscar", required = false) String q, @RequestParam(value="idExamen", required = false) Integer idExamen) {
    List<Tblagendalab> examenes = this.tblagendalabRepository.findByExamenLab(q);
    model.addAttribute("examenes", examenes);
    return "/views/agenda/agendar";
}

方案2：精确匹配ID（更高效）

如果你的需求是精确匹配ID值，完全不需要用LIKE，直接用等于操作符即可：

@Repository(value = "TblagendalabRepository")
public interface TblagendalabRepository extends JpaRepository<Tblagendalab, Integer>{
     
     @Query(value = "SELECT p FROM Tblagendalab p WHERE p.tblagendalabPK.idExamen = :q")
     List<Tblagendalab> findByExamenLab(@Param("q") Integer q);
}

这种情况下Controller层参数类型保持Integer不变，查询性能也比模糊匹配更优。

补充提示 #

• 若之前修改参数为String未生效，是因为没同步修改JPQL中的类型转换逻辑，必须确保把Integer字段转为字符串后再做LIKE匹配。
• 如果使用原生SQL查询（添加nativeQuery=true），类型转换语法需适配数据库：比如MySQL用CAST(id_examen AS CHAR)，PostgreSQL用CAST(id_examen AS TEXT)。

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