使用Spring Hateoas JSON API实现POST请求关联关系时遇报错

针对你用Spring Hateoas JSON API替代Crnk实现Book POST保存时，携带author关联就报错的问题，核心原因是JSON API规范下的关联资源格式不匹配，或者资源类/反序列化配置没跟上，以下是具体解决步骤：

1. 确保请求体严格遵循JSON API关联格式 #

JSON API对关联资源的格式有明确要求，不能直接嵌套对象或只传ID，必须通过relationships字段传递关联的type和id。举个正确的请求体示例：

{
  "data": {
    "type": "books",
    "attributes": {
      "title": "Spring in Action",
      "isbn": "9781617294945"
    },
    "relationships": {
      "author": {
        "data": {
          "type": "authors",
          "id": "1"
        }
      }
    }
  }
}

• 注意relationships里的author对应的数据必须包含type（和Author资源类的@JsonApiResource指定的type一致）和id。

2. 正确配置资源类的关联注解 #

你的Book和Author资源类需要用Spring Hateoas JSON API的注解声明关联：

Author资源类 #

@JsonApiResource(type = "authors")
public class AuthorResource extends RepresentationModel<AuthorResource> {
    private String id;
    private String name;

    // getter、setter
}

Book资源类 #

@JsonApiResource(type = "books")
public class BookResource extends RepresentationModel<BookResource> {
    private String id;
    private String title;
    private String isbn;

    @JsonApiRelationship(type = "authors")
    private AuthorResource author;

    // getter、setter
}

• 重点：@JsonApiRelationship的type必须和关联资源的@JsonApiResource(type)一致，框架靠这个匹配关联类型。

3. 调整Controller的请求参数绑定 #

如果你的Controller直接接收BookResource作为请求体，需要确保框架能正确解析关联的Author。如果是关联已存在的Author，你需要在Service层通过ID查询到对应的AuthorResource，再赋值给Book：

@RestController
@RequestMapping("/api/books")
public class BookController {

    private final BookService bookService;
    private final AuthorService authorService;

    // 构造注入

    @PostMapping
    public ResponseEntity<BookResource> createBook(@RequestBody JsonApiDocument<BookResource> document) {
        BookResource book = document.getData();
        
        // 处理关联的author：通过ID查询已有资源
        if (book.getAuthor() != null && book.getAuthor().getId() != null) {
            AuthorResource existingAuthor = authorService.getById(book.getAuthor().getId());
            book.setAuthor(existingAuthor);
        }
        
        BookResource savedBook = bookService.save(book);
        return ResponseEntity.created(URI.create("/api/books/" + savedBook.getId())).body(savedBook);
    }
}

• 这里用JsonApiDocument<T>包裹请求体，能更方便地获取符合JSON API规范的资源数据，避免直接绑定BookResource时的解析问题。

4. 检查依赖兼容性 #

确保你的Spring Boot和Spring Hateoas JSON API版本兼容，比如Spring Boot 3.x对应Spring Hateoas 2.x，依赖配置示例：

<!-- pom.xml -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-hateoas</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.hateoas</groupId>
    <artifactId>spring-hateoas-jsonapi</artifactId>
</dependency>

如果是Gradle：

implementation 'org.springframework.boot:spring-boot-starter-hateoas'
implementation 'org.springframework.hateoas:spring-hateoas-jsonapi'

5. 调试排查细节 #

如果还是报错，开启DEBUG日志查看反序列化过程：
在application.yml中添加：

logging:
  level:
    org.springframework.hateoas.jsonapi: DEBUG

通过日志可以看到框架解析关联时的具体步骤，定位是type不匹配、ID为空还是资源找不到导致的Link null问题。

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