REST API中POST请求规范行为问询：重复唯一索引场景处理

首先明确REST规范中POST的核心语义：POST用于提交请求以创建新资源，属于非幂等方法——重复发送相同POST请求，预期会产生不同结果（比如多次创建资源，除非有约束阻止）。

针对你提到的场景（id1+id2为唯一索引，已存在该组合数据时的处理），两种选项的分析：

• 选项1（返回已有数据，等同于GET）：违背POST的核心语义。POST的目的是创建新资源，而非查询已有资源。若客户端发送POST请求却得到查询结果，会误解请求执行结果（以为新资源已创建），破坏接口语义一致性。
• 选项2（返回异常）：更符合REST规范，但需返回正确的HTTP状态码和错误信息。

正确实现方式：

• 检测到id1+id2组合已存在时，返回409 Conflict状态码，同时在响应体中明确冲突原因（例如“该id1+id2组合的报告已存在”）。这个状态码的语义就是“请求与当前服务器状态冲突”，完全匹配唯一索引重复的场景。
• 若希望接口具备幂等性（比如客户端重复提交时不报错，返回已有资源），应考虑使用PUT方法而非POST——PUT的语义是“更新或创建指定资源”，本身是幂等的，更适合存在唯一业务键的场景。但如果坚持用POST，必须严格遵循其创建资源的语义，冲突时返回409异常。

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