如何在Passport OAuth2策略中传递错误信息至error.ejs页面？

一、获取错误并传递到error.ejs页面 #

你当前用failureRedirect的写法，Passport不会自动把错误信息带到重定向后的新请求里，所以req.error拿不到值。要解决这个问题，得改用自定义回调函数捕获认证错误，再手动传递给模板：

方法1：直接渲染error页面（无需重定向） #

这种方式能直接把错误传给模板，不会丢失上下文：

router.get(
  process.env.CALLBACK,
  (req, res, next) => {
    // 用自定义回调捕获认证结果
    passport.authenticate("oauth2", (err, user, info) => {
      // err：服务器端异常（比如网络错误、OAuth配置错误）
      if (err) {
        console.error("认证服务异常:", err);
        return res.render("error", { error: err.message || "认证服务出错" });
      }
      // !user：用户未通过认证（比如授权被拒绝、token无效），info是OAuth返回的错误详情
      if (!user) {
        console.error("认证失败详情:", info);
        return res.render("error", { error: info.message || "授权被拒绝或无效" });
      }
      // 认证成功，执行登录并跳转首页
      req.logIn(user, (loginErr) => {
        if (loginErr) return next(loginErr);
        return res.redirect("/");
      });
    })(req, res, next); // 手动调用认证函数
  }
);

在error.ejs里直接使用错误变量：

<!-- error.ejs -->
<h1>认证失败</h1>
<p><%= error %></p>

方法2：重定向并通过Flash消息传递错误（需依赖中间件） #

如果坚持要重定向到/error，可以用connect-flash存储错误信息（需先安装配置中间件）：

1. 安装依赖：

npm install express-session connect-flash

2. 配置中间件（放在Passport配置之前）：

const session = require('express-session');
const flash = require('connect-flash');

app.use(session({
  secret: 'your-custom-secret-key',
  resave: false,
  saveUninitialized: false
}));
app.use(flash());

3. 修改回调和error路由：

router.get(
  process.env.CALLBACK,
  (req, res, next) => {
    passport.authenticate("oauth2", (err, user, info) => {
      if (err) {
        req.flash('error', err.message || '认证服务出错');
        return res.redirect('/error');
      }
      if (!user) {
        req.flash('error', info.message || '授权被拒绝');
        return res.redirect('/error');
      }
      req.logIn(user, (loginErr) => {
        if (loginErr) return next(loginErr);
        return res.redirect("/");
      });
    })(req, res, next);
  }
);

router.get("/error", (req, res) => {
  // 取出Flash里的错误信息
  const error = req.flash('error')[0];
  res.render("error", { error });
});

二、重定向前打印错误信息 #

在自定义回调里，捕获到err或info后先打印到控制台，再执行后续逻辑：

router.get(
  process.env.CALLBACK,
  (req, res, next) => {
    passport.authenticate("oauth2", (err, user, info) => {
      // 先打印错误到控制台
      if (err) {
        console.log('=== 认证服务器错误 ===');
        console.log(err);
      }
      if (!user) {
        console.log('=== 认证失败详情 ===');
        console.log(info);
      }
      // 后续处理：渲染错误页或重定向
      if (err || !user) {
        return res.render("error", { error: err?.message || info?.message || "认证失败" });
      }
      req.logIn(user, (loginErr) => {
        if (loginErr) return next(loginErr);
        return res.redirect("/");
      });
    })(req, res, next);
  }
);

关键说明 #

• passport.authenticate的自定义回调会接收三个参数：err（服务器异常）、user（认证成功的用户对象）、info（OAuth返回的错误详情，比如invalid_grant、access_denied等）
• 默认的failureRedirect会发起新请求，无法携带错误上下文，所以必须用自定义回调才能拿到错误信息

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