Express清除Cookie失败：注册新用户时Cookie持续累加

问题描述 #

在Express框架中实现用户注册功能时，每次注册新用户，Cookie都会不断累加，无法清除已存在的Cookie。

相关代码 #

userRoutes.js #

const { registerUser, loginUser, registerVerify } = require("./userController");

const express=require('express')
const router=express.Router()

router
    .route('/register')
    .post(registerUser)

module.exports=router

userController.js #

const User = require("./userModel");
const validator = require("validator");
const jwt=require('jsonwebtoken')


const sendToken = function (email) {
  let data = {
    expiresIn: process.env.JWT_EXPIRE_SHORT,
    email,
  };
  let token = jwt.sign(data, process.env.JWT_SECRET_KEY);

  return token;
};

exports.registerUser = async (req, res, next) => {
  try {
    const { userName, email, password, confirmPassword } = req.body;
    let user = [
      { userName, email, password, confirmPassword, createdAt: Date.now() },
    ];

    //passwords do not match error
    if (password !== confirmPassword) {
      throw "Password doesn't match Confirm Password.";
    }

    //email not valid error
    if (!validator.isEmail(email)) {
      throw "Email not valid.";
    }

    //user already logged in error
    if (await User.findOne({ email })) {
      throw "User already exists. Please login";
    }

    //create user
    await User.create(user);

    //assign token
    let token = sendToken(email);

    //clear cookie
    
    res.status(200).clearCookie('token').cookie(token, 'token', {maxAge: 360000}).json({
      message: "Please fill the required text send via email",
      token,
    });
  } catch (err) {
    // console.log(err)
    res.status(400).json({
      message: "Signup Not Successfull",
      err,
    });
  }
};

已尝试的无效写法 #

router
    .route('/register',{ credentials: 'same-origin'})
    .post(registerUser)

router
    .route('/register',{ credentials: 'include'})
    .post(registerUser)

router
    .route('/register',{ withCredentials: true})
    .post(registerUser)

解决方案 #

1. 修正Cookie设置的参数顺序 #

核心错误是res.cookie的参数顺序颠倒，正确语法为res.cookie(name, value, options)。你之前把token值作为Cookie名称，导致每次生成新token就会新增不同名称的Cookie，clearCookie('token')无法匹配这些Cookie，最终造成累加。

修正后的Cookie操作代码：

// 替换原Cookie相关代码
res.status(200)
   .clearCookie('token', { path: '/' }) // 指定路径确保匹配目标Cookie
   .cookie('token', token, { 
       maxAge: 360000, 
       path: '/', // 与clearCookie保持路径一致
       // 可选：添加安全配置提升安全性
       httpOnly: true, 
       sameSite: 'strict'
   })
   .json({
     message: "请填写邮件发送的验证码",
     token,
   });

2. 正确配置跨域凭证（若存在跨域场景） #

你之前尝试的router.route写法错误，route方法不接受配置对象。需使用cors中间件完成凭证配置：

1. 安装cors包：

npm install cors

2. 在全局Express实例或当前路由中配置：

const cors = require('cors');

// 全局配置（app.js中）
app.use(cors({ 
  credentials: true, 
  origin: 'http://localhost:3000' // 替换为你的前端实际域名
}));

// 或仅在当前路由配置
router.use(cors({ credentials: true, origin: 'http://localhost:3000' }));

3. 确保clearCookie与设置Cookie的选项一致 #

如果设置Cookie时指定了domain、path等属性，clearCookie必须使用完全相同的选项才能匹配并清除Cookie。例如：

res.clearCookie('token', { path: '/', domain: '.yourdomain.com' });
res.cookie('token', token, { 
  maxAge: 360000, 
  path: '/', 
  domain: '.yourdomain.com',
  httpOnly: true
});

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