Spring Boot POST接口报500错误could not extract ResultSet

• 调用POST接口/api/marathon/baselineTools/resourceAssignments时返回500内部服务器错误，初步检查实体类代码后问题仍未解决。
• 接口逻辑：配置了权限校验规则，接收BaselineData类型的请求体参数，取出reportingProjectId转为字符串后，与phase参数一同调用Repository的查询方法获取ResourceAssignments列表，请求发起后直接抛出异常。

报错详情 #

接口返回的错误信息如下：

{
  "timestamp": 1654227336348,
  "status": 500,
  "error": "Internal Server Error",
  "message": "could not extract ResultSet; SQL [n/a]; nested exception is org.hibernate.exception.SQLGrammarException: could not extract ResultSet",
  "path": "/api/marathon/baselineTools/resourceAssignments"
}

问题接口代码 #

@RequestMapping(value = "resourceAssignments", method = RequestMethod.POST)
@PreAuthorize("isFullyAuthenticated() && (hasRole('ROLE_ADMIN') || hasRole('ROLE_BASELINETOOLS'))")
public List<ResourceAssignments> getResourceAssignments(@RequestBody BaselineData data) {
    int reportingProjectId = data.getReportingProjectId();
    String phase = data.getPhase();
    return this.resourceAssignmentsRepository.findAllByReportingProjectIdAndPhase(String.valueOf(reportingProjectId), phase);
}

报错核心是org.hibernate.exception.SQLGrammarException，本质是Hibernate生成的SQL存在语法错误，和数据库实际结构/规则不匹配，按以下优先级排查：

• 核对实体类与数据库表的映射一致性
  1. 确认ResourceAssignments对应的数据库表中，真实存在reporting_project_id、phase字段，字段名和实体类@Column注解配置的名称完全匹配，注意不同数据库的大小写、下划线规则差异：Linux环境下MySQL默认大小写敏感，PostgreSQL默认将未加引号的字段名自动转为小写，映射名称不匹配会直接查询不存在的列触发语法错误。
  2. 核对字段类型：代码中特意将int类型的reportingProjectId转为字符串传入查询方法，需确认数据库中reporting_project_id的字段类型、实体类中对应属性的类型是否和传入参数类型匹配，类型不匹配会导致Hibernate生成SQL时参数绑定逻辑异常。
  3. 检查实体类中是否存在非表字段的属性，如果有业务逻辑需要的临时属性，必须加@Transient注解，否则Hibernate会默认将其作为表字段查询，触发列不存在的语法错误。
• 核对Repository方法定义
  确认resourceAssignmentsRepository中findAllByReportingProjectIdAndPhase方法的参数顺序、参数类型和传入值完全对应：如果方法第一个参数声明为Integer类型，实际传入String类型值，会导致Hibernate生成查询语句时参数类型不匹配，触发SQL异常。如果实体类存在表关联（@ManyToOne/@OneToMany等），同步检查关联配置的字段、关联表映射是否正确，关联配置错误是这类异常的高频触发点。
• 开启SQL打印定位具体错误
  在项目配置文件中添加如下配置，打印Hibernate实际生成的SQL语句和绑定参数，将打印的SQL直接在数据库客户端执行，就能快速定位具体语法错误点：

  spring:
    jpa:
      show-sql: true
      properties:
        hibernate:
          format_sql: true
  logging:
    level:
      org.hibernate.type.descriptor.sql.BasicBinder: TRACE
  

• 兜底检查项
  确认应用连接数据库使用的账号，拥有ResourceAssignments对应表的查询权限，部分数据库驱动会将权限不足的错误包装为SQLGrammarException抛出，容易误导排查方向。

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