Spring Boot中Hateoas RepresentationModelAssembler丢失指定字段问题

在使用Spring Boot Hateoas的RepresentationModelAssembler实现GET接口时，返回的JSON仅包含createdAt、caption和_links字段，缺失Post实体的id和user字段。已尝试@JsonInclude、@JsonProperty、移除Lombok手动编写getter/setter、将id设为public等方法均无效；添加@JsonIdentityInfo时触发序列化错误：

类型定义错误: [简单类型，类com.example.demo.model.Post]
无效的对象ID定义com.example.demo.model.Post: 无法找到名为'id'的属性（通过引用链: org.springframework.hateoas.EntityModel["content"]）

解决方案 #

1. 检查Hateoas与Jackson版本兼容性 #

确保spring-boot-starter-hateoas依赖与Spring Boot版本匹配，避免版本冲突导致的序列化异常。Maven依赖示例：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-hateoas</artifactId>
</dependency>

2. 修复@JsonIdentityInfo配置 #

错误提示找不到id属性，可显式指定getter方法或用@JsonProperty标记字段：

@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id", getter = "getId")
@Entity(name = "post")
@Data
@AllArgsConstructor
@NoArgsConstructor
@Builder
public class Post {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @JsonProperty("id")
    private Long id;

    // 其余字段保持不变
}

3. 解决User字段懒加载序列化问题 #

user字段为@ManyToOne懒加载，Jackson默认无法序列化未初始化的代理对象，可通过以下方式处理：

• 改用饿汉加载（不适合大数据量场景）：

  @ManyToOne(fetch = FetchType.EAGER)
  @JoinColumn(name = "user_id")
  private User user;
  

• 使用Hibernate Jackson模块：
  添加依赖：

  <dependency>
      <groupId>com.fasterxml.jackson.datatype</groupId>
      <artifactId>jackson-datatype-hibernate5</artifactId>
  </dependency>
  

  配置Jackson：

  @Configuration
  public class JacksonConfig {
      @Bean
      public Module hibernateModule() {
          return new Hibernate5Module();
      }
  }
  

4. 自定义Assembler序列化逻辑 #

手动构建返回数据，避免依赖自动序列化，同时可控地处理懒加载字段：

@Component
public static class PostModelAssembler implements RepresentationModelAssembler<Post, EntityModel<Map<String, Object>>> {
    @Override
    public @NonNull EntityModel<Map<String, Object>> toModel(@NonNull Post post) {
        Map<String, Object> postData = new HashMap<>();
        postData.put("id", post.getId());
        postData.put("createdAt", post.getCreatedAt());
        postData.put("caption", post.getCaption());
        
        // 安全处理user字段，避免懒加载异常
        if (post.getUser() != null) {
            Map<String, Object> userData = new HashMap<>();
            userData.put("id", post.getUser().getId());
            // 添加其他需要展示的User字段，如username等
            postData.put("user", userData);
        }

        return EntityModel.of(postData,
                linkTo(methodOn(PostController.class).one(post.getId())).withSelfRel()
        );
    }
}

同时修改接口返回类型：

@GetMapping("/{postId}")
public EntityModel<Map<String, Object>> one(@PathVariable Long postId) {
    Post post = postRepository.findById(postId)
            .orElseThrow(() -> new CustomExceptionHandling.ResourceNotFoundException("Post", "ID", postId));
    return assembler.toModel(post);
}

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