Spring Data REST一对一映射GET请求触发500内部服务器错误

这个错误HttpMessageNotWritableException加上找不到java.lang.Long的message字段，大概率是实体双向关联引发的Jackson循环序列化问题，或者是序列化配置/自定义序列化器的错误导致的。下面是一步步的排查和解决方法：

1. 检查实体双向关联的序列化处理 #

如果你的Customer和Address是双向关联（比如@OneToOne、@OneToMany/@ManyToOne），Jackson在序列化时会循环遍历两个实体，最终引发序列化异常（错误信息可能表现为找不到字段的变体）。

解决方案：用Jackson注解阻断循环引用 #

• 方法一：在关联的一方添加@JsonIgnore，直接忽略该关联字段的序列化：

  // Address实体类
  @Entity
  public class Address {
      @Id
      @GeneratedValue(strategy = GenerationType.IDENTITY)
      private Long id;
      private String street;
  
      // 双向关联的Customer字段，添加@JsonIgnore避免循环序列化
      @OneToOne(mappedBy = "address")
      @JsonIgnore
      private Customer customer;
  
      // getter/setter
  }
  

• 方法二：用@JsonManagedReference和@JsonBackReference配对使用，指定序列化的方向：

  // Customer实体类
  @Entity
  public class Customer {
      @Id
      @GeneratedValue(strategy = GenerationType.IDENTITY)
      private Long id;
      private String name;
  
      @OneToOne(cascade = CascadeType.ALL)
      @JoinColumn(name = "address_id")
      @JsonManagedReference // 标记为主序列化方，会被正常序列化
      private Address address;
  
      // getter/setter
  }
  
  // Address实体类
  @Entity
  public class Address {
      @Id
      @GeneratedValue(strategy = GenerationType.IDENTITY)
      private Long id;
      private String street;
  
      @OneToOne(mappedBy = "address")
      @JsonBackReference // 标记为反向关联，序列化时会被忽略
      private Customer customer;
  
      // getter/setter
  }
  

2. 验证Spring Data REST的Repository配置 #

确保你的Repository接口正确继承了JpaRepository，并且Spring Data REST能正确识别资源：

@RepositoryRestResource(collectionResourceRel = "customers", path = "customers")
public interface CustomerRepository extends JpaRepository<Customer, Long> {
}

如果不需要暴露关联的Address资源，也可以通过@RepositoryRestResource的excerptProjection自定义返回的字段，避免序列化关联实体。

3. 排查自定义序列化器（如果有） #

如果你为Long类型或实体类自定义了序列化器，检查是否有错误逻辑。比如错误地尝试访问Long类的message字段：

// 错误示例：试图调用Long的get("message")方法，会引发找不到字段的错误
public class InvalidLongSerializer extends StdSerializer<Long> {
    public InvalidLongSerializer() {
        super(Long.class);
    }

    @Override
    public void serialize(Long value, JsonGenerator gen, SerializerProvider provider) throws IOException {
        gen.writeObject(value.get("message")); // Long没有这个方法，直接报错
    }
}

如果有这类错误，修正自定义序列化器的逻辑即可。

4. 临时调试配置（不推荐长期使用） #

如果以上方法都没解决，可以临时添加Spring Boot配置来排查问题：

# 禁用空Bean序列化失败的检测
spring.jackson.serialization.fail-on-empty-beans=false
# 忽略未知字段的反序列化错误
spring.jackson.deserialization.fail-on-unknown-properties=false

注意：这只是临时调试手段，长期使用可能隐藏其他序列化问题，建议找到根源后移除。

内容的提问来源于stack exchange，提问作者D.Kaushish