为何使用PassportJS无法完成认证？Node.js认证模块故障排查

核心问题分析及修复步骤 #

1. 数据库字段拼写错误 #

你的UserSchema里存在两处拼写错误：

• 密码字段写成了passpwod，正确应为password
• 字段校验属性写成了require，正确应为required

这会导致Mongoose无法正确映射数据库中的密码字段，即使你手动创建了用户，查询时也无法匹配到正确的密码值。

修复后的UserSchema代码：

const UserSchema = new mongoose.Schema({
    username: {
        type: String,
        required: true
    },
    password: {
        type: String,
        required: true
    }
})

2. Local Strategy缺少密码验证逻辑 #

当前代码仅实现了用户查询，没有对比输入密码与数据库中存储的哈希密码，这是Passport认证失败的关键原因。

首先安装兼容更好的bcrypt库：

npm install bcryptjs

然后修改Local Strategy，添加密码验证逻辑：

const bcrypt = require('bcryptjs'); // 替换原有的password-hash-and-salt

passport.use(new LocalStrategy(function(username, password, done){
    console.log('find user');
    User.findOne({username: username}, function(err, user){
        if(err) {return done(err)}
        if(!user) {return done(null, false, {message: 'Incorrect User.'})};
        
        // 对比输入密码与数据库哈希密码
        bcrypt.compare(password, user.password, function(err, isMatch) {
            if (err) return done(err);
            if (!isMatch) return done(null, false, { message: 'Incorrect password.' });
            return done(null, user);
        });
    })
}))

3. 确保用户密码以哈希形式存储 #

你手动创建用户时，必须将明文密码通过bcrypt哈希后再存入数据库，否则验证会直接失败。可以在Node.js终端生成哈希值：

const bcrypt = require('bcryptjs');
bcrypt.hash('你的明文密码', 10, (err, hash) => {
    console.log(hash); // 将此哈希值作为password字段存入users集合
});

4. 可选：完善数据库连接错误处理 #

添加连接状态提示，便于排查数据库问题：

mongoose.connect("mongodb://localhost:27017/test", {
    useNewUrlParser: true,
    useUnifiedTopology: true
})
.then(() => console.log('MongoDB连接成功'))
.catch(err => console.error('MongoDB连接失败:', err));

测试修复后的请求 #

使用curl测试时，确保发送格式正确的请求：

• 表单格式：

curl -X POST -d "username=你的用户名&password=你的明文密码" http://localhost:4000/login

• JSON格式：

curl -X POST -H "Content-Type: application/json" -d '{"username":"你的用户名","password":"你的明文密码"}' http://localhost:4000/login

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