社交平台用户关注API遇Put请求返回空对象问题排查

1. 路由匹配顺序错误（最可能的直接原因） #

你的路由定义顺序存在逻辑问题：

router.put("/:id",updateUser) // 先定义了通用的PUT路由
router.put("/:id/follow", followUser) // 更具体的路由在后方

Express 会按照路由定义的顺序匹配请求，当你发送 PUT /user/xxx/follow 时，第一个路由 /:id 会把 xxx/follow 完整当作 id 参数，直接匹配到 updateUser 控制器，而非目标的 followUser。如果 updateUser 未处理这种异常请求，就会返回空对象 {}。

修复方式：将更具体的路由放在通用路由之前：

router.put("/:id/follow", followUser) // 优先匹配具体路由
router.put("/:id",updateUser) // 再匹配通用路由

2. Express 未配置 JSON 请求体解析 #

如果你的 index.js 中没有添加 express.json() 中间件，Express 无法解析 JSON 格式的请求体，会导致 req.body.currentUserId 为 undefined，后续逻辑抛出错误后，直接 res.send(error) 可能返回空对象。

修复方式：在 index.js 中添加请求体解析中间件：

const express = require('express')
const app = express()

// 解析 JSON 格式请求体
app.use(express.json())

app.use("/user", UserRoute)
// ...其他配置

3. Mongoose 数组类型定义不规范 #

UserSchema 中 followers 和 following 直接定义为 []，Mongoose 会默认将其视为 Mixed 类型，可能引发后续操作的类型校验或更新异常。

修复方式：明确指定数组类型为关联用户的 ObjectId：

const UserSchema = mongoose.Schema({
  // ...其他字段
  followers: [{ type: mongoose.Schema.Types.ObjectId, ref: 'Users' }],
  following: [{ type: mongoose.Schema.Types.ObjectId, ref: 'Users' }]
}, { timestamps: true })

4. 错误处理逻辑优化 #

当前错误处理中直接 res.send(error)，Mongoose 错误对象可能无法被正确序列化为 JSON，导致返回空对象。建议优化为：

catch (error) {
  res.status(500).json({ message: error.message, detail: error })
}

5. Postman 请求格式校验 #

确保 Postman 请求符合要求：

• 请求方法选择 PUT
• URL 格式正确：http://localhost:端口号/user/目标用户ID/follow
• Body 标签选择 raw -> JSON，正确传递参数：

{
  "currentUserId": "当前登录用户的ID"
}

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