如何修改Passport Local配置，实现邮箱替代用户名登录？

问题描述 #

当前使用passport-local做身份认证时，默认采用用户名+密码登录，但需求是改为邮箱+密码登录，现有登录流程无法正常工作，需要调整LocalStrategy的配置。

解决方案 #

1. 修改LocalStrategy配置，指定邮箱为登录标识 #

passport-local默认会从请求中读取username和password字段验证身份，我们需要覆盖这个默认规则，指定用email作为登录标识字段。

方式一：在Schema插件中配置（推荐）

如果你使用passport-local-mongoose插件，在定义用户Schema时直接指定usernameField为email：

const passportLocalMongoose = require('passport-local-mongoose');
const userSchema = new mongoose.Schema({
  // 你的字段定义：email、name等
});

// 配置插件，指定登录标识为email
userSchema.plugin(passportLocalMongoose, { 
  usernameField: 'email'
});

// 创建并使用策略
const strategy = new LocalStrategy(userSchema.authenticate());
passport.use(strategy);

方式二：直接在LocalStrategy中传入选项

如果不想修改Schema插件配置，也可以在实例化LocalStrategy时传入自定义字段选项：

const strategy = new LocalStrategy(
  { 
    usernameField: 'email', // 指定用email作为登录标识字段
    passwordField: 'password' // 密码字段保持默认，可省略
  }, 
  userSchema.authenticate()
);
passport.use(strategy);

2. 确保登录接口参数匹配 #

你的登录接口已经从req.body中获取了email和password，这部分无需修改，只需确保前端提交的表单字段名是email和password（和配置的字段名一致）即可。修改后的登录逻辑如下：

app.post('/login', function (req, res) {
  const state = req.query.state
  
  passport.authenticate("local", function (err, user, info) {
    if (err) {
      return res.render('login', { error: err, state: state })
    }
    if (!user) {
      return res.render('login', { error: `The email or password entered is incorrect`, state: state })
    }
    const token = jwt.sign({ userId: user._id, email: user.email }, secretkey, { expiresIn: "24h" });
    res.json({ success: true, message: "Authentication successful", token: token });
  })(req, res);
})

3. 注册逻辑无需额外修改 #

你的注册代码已经做了邮箱唯一性校验，且在userSchema.register中传入了email字段，修改LocalStrategy配置后，passport-local-mongoose会自动用email作为登录验证的唯一标识，注册逻辑保持原样即可。

关键说明 #

• 修改usernameField后，passport-local会自动从请求体中读取指定的字段（此处为email）替代默认的username。
• 若使用passport-local-mongoose，插件会自动处理用户查找、密码哈希等核心逻辑，只需指定正确的字段名即可。

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