2023年Node.js中Passport Facebook登录策略失效问题求助

1. 修复代码语法错误 #

你的/auth/facebook接口存在语法错误，缺少闭合括号，会导致服务器无法正常响应请求：

// 错误代码
app.get('/auth/facebook', passport.authenticate('facebook', { display: 'popup' });

// 修正后
app.get('/auth/facebook', passport.authenticate('facebook', { display: 'popup' }));

2. 补充Passport序列化/反序列化逻辑 #

Passport必须配置序列化和反序列化才能管理用户会话，缺失这部分会导致登录后应用挂起：

passport.serializeUser((user, done) => {
  done(null, user);
});

passport.deserializeUser((obj, done) => {
  done(null, obj);
});

3. 前端正确触发弹窗登录 #

直接用a标签或表单提交会在当前页面跳转，无法弹出独立窗口。需通过JavaScript调用window.open触发：

// 前端按钮点击事件示例
document.getElementById('facebook-login-btn').addEventListener('click', () => {
  window.open('/auth/facebook', 'FacebookLogin', 'width=600,height=650');
});

4. Meta开发者后台配置检查 #

• 回调URL完全匹配：在「产品 > Facebook登录 > 设置」的「有效的OAuth重定向URI」中，添加与代码一致的地址http://localhost:3000/auth/facebook/cb，协议、端口、路径必须完全相同。
• 应用状态与权限：若应用处于开发模式，仅添加到「测试用户」列表的账号可登录；如需公开访问，需将应用状态切换为「公开」。
• 启用OAuth选项：确保「客户端OAuth登录」「Web OAuth登录」已开启，本地开发可暂时关闭「强制HTTPS」选项。

5. 优化回调接口逻辑 #

当前回调直接返回res.user（应为req.user）且未处理弹窗关闭，导致应用挂起。修改为：

app.get('/auth/facebook/cb', 
  passport.authenticate('facebook', { failureRedirect: '/login' }),
  (req, res) => {
    // 关闭登录弹窗并通知父页面刷新
    res.send(`<script>
      window.close();
      if(window.opener) window.opener.location.reload();
    </script>`);
  }
);

6. 开启调试日志排查 #

启动服务器时添加环境变量开启Passport调试日志，查看认证流程细节：

# Linux/macOS
DEBUG=passport:* node app.js

# Windows
set DEBUG=passport:* && node app.js

内容的提问来源于stack exchange，提问作者Dagg M.