Spring Boot 3.1.0 REST接口无法返回User实体id字段问题求助

以下是几种常见的原因及对应解决方法：

1. Spring Data REST 默认隐藏主键字段 #

Spring Boot 3.1.0 集成的 Spring Data REST 会默认隐藏被@Id注解标记的主键字段，尤其是当你使用 Spring Data JPA Repository 并且接口是由 Spring Data REST 自动生成时，主键不会被序列化返回。

解决方法二选一：

• 在实体类的主键 getter 方法上添加@RestResource(exported = true)，显式允许暴露主键：

  @Id
  @Column(name = "user_id")
  private Long id;
  
  @RestResource(exported = true)
  public Long getId() {
      return id;
  }
  

• 配置全局的 RepositoryRestConfigurer，指定需要暴露主键的实体类：

  @Configuration
  public class CustomRestConfig implements RepositoryRestConfigurer {
      @Override
      public void configureRepositoryRestConfiguration(RepositoryRestConfiguration config) {
          // 暴露User实体的主键
          config.exposeIdsFor(User.class);
      }
  }
  

2. 实体字段映射不匹配 #

确认你的@Id字段是否正确映射到数据库的user_id字段，如果没有添加@Column注解指定字段名，JPA 会默认按驼峰转下划线规则映射（比如id对应id字段，而不是user_id），导致从数据库查询时主键字段未被正确赋值，自然返回结果中没有id。

解决方法：给@Id字段添加@Column注解明确映射关系：

@Id
@Column(name = "user_id")
private Long id;

3. Jackson 序列化策略被覆盖 #

如果项目中存在自定义的 Jackson 配置（比如全局的ObjectMapper配置），可能覆盖了默认的序列化规则，导致主键字段被排除。

解决方法：在实体类上添加@JsonAutoDetect注解，强制 Jackson 序列化所有字段：

@Entity
@Table(name = "user")
@JsonAutoDetect(fieldVisibility = JsonAutoDetect.Visibility.ANY)
public class User {
    // ... 其他字段
}

4. 投影（Projection）过滤了主键 #

如果你的接口使用了 Spring Data REST 的投影（Projection）机制，而投影类中没有包含主键的 getter 方法，返回结果会自动过滤掉主键字段。

解决方法：检查是否存在针对User实体的投影类，确保其中包含主键的 getter 方法：

@Projection(name = "userProjection", types = User.class)
public interface UserProjection {
    String getUsername();
    // 添加主键的getter
    Long getId();
}

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