REST HAL最佳实践：POST创建Employee时用嵌套对象还是关联链接？

两种关联方式的对比与最佳实践 #

链接关联方式（推荐） #

使用_links携带Manager的URI的方式，完全符合REST和HAL的设计理念，是Spring Data Rest+HATEOAS场景下的最佳实践：

{
    "firstname": "John",
    "lastname": "Smith",
    "_links" : {
      "manager" : {
        "href" : "http://localhost:8080/api/manager/123"
      }
    }
}

REST的核心是通过**资源标识符（URI）**引用资源，而非传递完整嵌套对象。这种方式能解耦Employee和Manager的资源表示，后端只需通过URI定位已存在的Manager资源即可完成关联，无需处理冗余字段数据，还能完美适配Spring Data Rest的自动资源管理机制，避免额外配置。

嵌套对象方式（不推荐） #

嵌套提交Manager对象的方式虽能实现功能，但存在明显弊端：

{
    "firstname": "John",
    "lastname": "Smith",
    "manager": {"id":123, "firstname": "Albert", "lastname": "Doe"}
}

你遇到的需要添加@RestResource(exported = false)的情况，是因为Spring Data Rest默认会将关联实体暴露为可访问的REST端点。直接嵌套提交时，框架会尝试处理整个Manager对象的持久化逻辑，添加该注解是为了告诉框架不要暴露Manager的这个关联端点，避免不必要的资源暴露。但这种方式不符合REST的资源引用原则，会带来数据冗余，且如果Manager字段发生变更，提交的嵌套数据极易出现不一致问题。

HAL是否强制使用链接？ #

HAL本身并没有强制要求必须通过链接关联资源，它只是定义了超媒体链接的标准格式（即_links字段的结构）。但在Spring Data Rest生态中，由于它基于HATEOAS（超媒体作为应用状态引擎）实现，官方强烈推荐用链接关联资源——这符合REST成熟度模型的Level 3（超媒体控制）要求，也能更好地利用框架的自动资源发现、管理能力。所以不是HAL强制，而是Spring Data Rest场景下的最佳实践要求。

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