Passport JS Google OAuth策略报错：Cannot GET /auth/google 求助

以下是几个常见的排查方向和修复方案：

1. 确认Passport核心中间件已正确初始化 #

你的代码仅配置了GoogleStrategy和路由，但可能遗漏了Passport的初始化步骤。在Express应用中，必须先挂载Passport的核心中间件，否则认证路由无法生效：

// 务必在挂载/auth/google路由前添加这些代码
const passport = require('passport');
app.use(passport.initialize());
// 若使用会话持久化用户状态，还需添加以下代码（需配合express-session中间件）
// app.use(passport.session());

2. 检查路由挂载顺序 #

Express路由按匹配顺序执行，如果/auth/google路由挂载在404处理路由之后，请求会被404路由拦截。确保认证路由在全局中间件（如请求体解析、静态文件服务）之后，但在404/错误处理路由之前：

// 正确顺序示例：
app.use(express.json()); // 请求体解析中间件
app.use(express.static('public')); // 静态文件服务中间件

// 挂载认证路由
app.get(
  "/auth/google",
  passport.authenticate("google", { scope: ["email", "profile"] })
);
app.get(
  "/auth/google/callback",
  passport.authenticate("google", {
    successRedirect: "/dashboard",
    failureRedirect: "/users/login",
  })
);

// 最后挂载404路由
app.use((req, res) => {
  res.status(404).send('Not Found');
});

3. 修复GoogleStrategy回调中的错误 #

你的Strategy回调函数使用了未定义的err变量，这会导致认证过程抛出错误（虽不是路由找不到的直接原因，但会影响后续流程），应修改为：

passport.use(
  new GoogleStrategy(
    {
      clientID: googleClientId,
      clientSecret: googleClientSecret,
      callbackURL: "http://localhost:3000/auth/google/callback",
      passReqToCallback: true,
    },
    function (request, accessToken, refreshToken, profile, done) {
      // 无错误时第一个参数传null
      return done(null, profile);
      // 若需处理用户查找/创建逻辑，示例：
      // User.findOrCreate({ googleId: profile.id }, (err, user) => {
      //   return done(err, user);
      // });
    }
  )
);

4. 确认路由挂载到正确的Express实例 #

如果项目使用模块化路由（如将认证路由单独放在文件中），需确保已将路由模块注册到主Express应用：

// authRoutes.js中定义路由
const express = require('express');
const router = express.Router();
const passport = require('passport');

router.get(
  "/google",
  passport.authenticate("google", { scope: ["email", "profile"] })
);
// ... 其他路由

// 主app.js中导入并注册
const authRoutes = require('./authRoutes');
app.use('/auth', authRoutes);

5. 验证配置变量是否正确加载 #

确保googleClientId和googleClientSecret已正确定义，比如通过dotenv读取.env文件：

require('dotenv').config();
const googleClientId = process.env.GOOGLE_CLIENT_ID;
const googleClientSecret = process.env.GOOGLE_CLIENT_SECRET;

内容的提问来源于stack exchange，提问作者Syed Shuja Shah