axios发送POST请求存数据到MongoDB Atlas返回409错误如何解决

错误本质 #

HTTP 409状态码代表请求资源冲突，说明本次提交的写入请求和服务器端已有的资源状态不兼容，结合你往MongoDB Atlas写入新帖子的场景，90%以上的触发原因是MongoDB唯一索引重复。

常见触发原因 #

• MongoDB集合对应字段设置了唯一索引，你本次提交的请求体中该字段值已经在数据库中存在，MongoDB抛出E11000 duplicate key error后，后端返回409状态码
• 短时间内重复提交了完全相同的请求，后端没有做幂等校验，触发冲突
• 后端/posts/api/newPost路由代码中主动做了重复数据判断，匹配到重复内容后主动返回409状态码

排查步骤 #

1. 查看后端服务的运行日志，确认写入MongoDB时抛出的具体错误，如果是E11000开头的错误，即可确认是唯一索引冲突
2. 检查MongoDB的posts集合索引配置，确认给哪些字段设置了唯一索引，是不是误将非唯一属性（比如标题、内容）设置成了唯一索引
3. 打开浏览器开发者工具的网络面板，查看本次POST请求的请求体内容，对比数据库中已有的数据，确认是否有字段值重复
4. 检查后端/newPost路由的业务逻辑，确认是否存在主动判断重复返回409的代码逻辑

解决方案 #

• 如果是误加的唯一索引导致的冲突，直接删除多余的唯一索引即可
• 如果确实需要做字段去重，前端增加防重复提交逻辑：提交后按钮置灰，请求完成前禁止二次点击，后端同步增加幂等校验
• 前端axios捕获错误时针对性处理409错误，给用户友好提示：

axios.post('/posts/api/newPost', postData)
  .then(res => {
    // 写入成功后的业务逻辑
  })
  .catch(err => {
    if (err.response?.status === 409) {
      console.log('提交内容重复，请勿重复提交', err.response.data)
      // 此处可以加弹窗提示用户的逻辑
    }
  })

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