POST响应最佳实践：返回实体还是服务器端重定向？

我开发了一款允许用户更新数据库信息的应用，目前有两种POST请求处理的实现方式：

第一种是更新成功后返回响应实体：

public Response updatePerson(@PathParam("id") int id, @FormParam("name") String name) throws Exception {
    Profile profile = new Profile(id, name);
    manager.updateProfile(id, person);
    return Response.status(201).entity("Profile updated.").build();
}

第二种是更新成功后执行服务器端重定向：

public Response updatePerson(@PathParam("id") int id, @FormParam("name") String name) throws Exception {
    Person person = new Person(id, name);
    manager.updatePerson(id, person);
    return Response.seeOther(new URI("/home")).build();
}

我现在有两个疑问：

1. POST方法返回响应的最佳实践是什么？是否需要返回响应实体确认成功，还是仅状态码足够？
2. 能否同时实现返回响应实体和执行重定向操作？

1. POST请求响应的最佳实践 #

这得看你的客户端类型来定：

• 如果是浏览器表单提交：传统最佳实践是返回303 See Other重定向到一个GET页面。这么做的核心原因是避免用户刷新页面时重复提交POST请求（毕竟刷新会重新发送最后一次请求），防止数据被重复更新。这种场景下，状态码+重定向目标就足够了——浏览器会自动跳转到目标页面，用户最终看到的是目标页的内容，你可以在目标页通过会话或URL参数展示成功提示。
• 如果是API客户端（比如前端AJAX、移动端应用）：更合适的做法是返回明确的成功状态码（更新操作推荐用200 OK，201 Created一般用于创建新资源），同时返回响应实体。实体可以是更新后的完整资源对象，或者简洁的成功提示信息。因为API客户端需要明确知晓操作结果，不会自动处理重定向（除非特意配置），而且返回完整资源能让客户端直接拿到最新数据，省去额外的查询请求。

总结下来：状态码是必须的，响应实体是否需要取决于客户端的需求和场景。如果你的应用同时支持浏览器和API访问，可以通过请求头（比如Accept）来区分处理逻辑。

2. 能否同时返回响应实体和执行重定向？ #

直接同时实现是做不到的——因为HTTP协议规定一个响应只能有一个状态码，要么返回成功状态码+实体内容，要么返回重定向状态码+Location头，二者不可兼得。不过有两种变通方案可以达到类似效果：

• 浏览器场景：重定向后展示提示：在重定向的目标页面（比如/home）中，通过URL参数、Session会话或者Flash消息传递成功信息。比如重定向到/home?status=profile_updated，然后页面加载时读取这个参数，在页面上显示“Profile updated.”的提示。这是Web应用中最常用的做法。
• API场景：让客户端自主处理：如果是API客户端，可以返回一个包含成功信息和重定向URL的JSON实体，把控制权交给客户端。比如返回这样的响应：

  {
    "message": "Profile updated.",
    "redirectUrl": "/home"
  }
  

  前端拿到这个响应后，可以先显示成功提示，再手动跳转到指定的URL；移动端则可以根据业务逻辑决定是否跳转或做其他操作。

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