后端updateWalletById控制器无法正常工作的排查求助

问题现象 #

• 调用接口 http://localhost:3001/wallets/{walletID}（替换为实际钱包ID），请求体为 {"balance": 100}，返回400错误：

{
    "hasError": true,
    "message": "ERROR: Data Validation Failed.",
    "error": {
        "error": "'walletId' is required. 'balance' is not allowed."
    }
}

• 改用 http://localhost:3001/wallets/{_walletId}（替换为实际钱包ID）发起相同请求，仍返回400错误：

{
    "hasError": true,
    "message": "ERROR: Data Validation Failed.",
    "error": {
        "error": "'walletId' contains an invalid value."
    }
}

控制器代码 #

/**
 * this controller updates specific wallet via walletId & returns it
 * @async
 * @param {obj} req - incoming request obj
 * @param {obj} res - outgoing response obj
 * @param {func} next - method to pass control to next request handler in queue
 * @returns updated record from database
 */
const updateWalletById = async (req, res, next) => {
  try {
    const walletId = req.params.walletId; // Fetch walletId from request params
    const balance = req.body.balance; // Fetch balance from request body

    // Update the balance in the database
    const updatedWallet = await Wallet.findByIdAndUpdate(
      walletId,
      { balance },
      { new: true }
    );

    // Check if the wallet was found
    if (!updatedWallet) {
      return res.status(NOT_FOUND).json({
        hasError: true,
        message: 'Wallet not found',
      });
    }

    return res.status(SUCCESS).json({
      hasError: false,
      message: 'Wallet updated successfully',
      data: {
        wallet: updatedWallet,
      },
    });
  } catch (error) {
    logError('ERROR @ updateWalletById -> wallet.controllers.js', error);

    return res.status(SERVER_ERROR).json({
      hasError: true,
      message: 'ERROR: Requested operation failed.',
      error: {
        error: 'An unexpected error occurred on the server.',
      },
    });
  }
};

关键排查点 #

1. 请求校验规则不匹配：错误提示明确指向校验失败，说明存在Joi、express-validator这类校验中间件，且规则和接口逻辑冲突：
   • 校验规则可能要求walletId从请求体传入，但实际接口是从URL参数获取；
   • 校验规则可能禁止请求体包含balance字段，和更新逻辑矛盾。
2. 路由参数名不一致：如果路由定义的参数名不是walletId（比如写成_walletId），会导致req.params.walletId取不到值，触发校验的必填项错误。
3. 参数格式校验错误：第二个错误提示'walletId' contains an invalid value，可能是传入的钱包ID不符合MongoDB ObjectId格式，但错误来自校验环节，需先确认校验规则对ID格式的要求。

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