如何结合PassportJS GitHub策略与ApolloServer？端口方案解析

1. 让PassportJS与GraphQL端点协同工作 #

核心是把Passport的认证逻辑集成到ApolloServer所在的Node.js服务器（比如Express）中，而非单独开端口。具体操作步骤：

• 配置Passport GitHub策略，填写GitHub OAuth的客户端ID、密钥和回调地址
• 将Passport的初始化、会话管理中间件添加到Express实例
• 挂载Passport的认证路由（比如/auth/github发起授权、/auth/github/callback处理回调）
• 在ApolloServer的上下文（context）中，从请求对象提取已认证的用户信息，供GraphQL resolver调用

示例代码：

const express = require('express');
const { ApolloServer } = require('@apollo/server');
const { expressMiddleware } = require('@apollo/server/express4');
const passport = require('passport');
const GitHubStrategy = require('passport-github2').Strategy;
const session = require('express-session');

const app = express();

// 配置会话（Passport依赖会话存储用户认证状态）
app.use(session({
  secret: 'your-custom-secret-key',
  resave: false,
  saveUninitialized: false
}));

// 初始化Passport
app.use(passport.initialize());
app.use(passport.session());

// 配置GitHub OAuth策略
passport.use(new GitHubStrategy({
  clientID: 'YOUR_GITHUB_CLIENT_ID',
  clientSecret: 'YOUR_GITHUB_CLIENT_SECRET',
  callbackURL: 'http://localhost:4000/auth/github/callback'
}, (accessToken, refreshToken, profile, done) => {
  // 这里可根据业务逻辑处理用户（比如存入数据库）
  return done(null, profile);
}));

// 序列化/反序列化用户（用于会话存储）
passport.serializeUser((user, done) => done(null, user));
passport.deserializeUser((obj, done) => done(null, obj));

// 挂载Passport认证路由
app.get('/auth/github', passport.authenticate('github', { scope: ['user:email'] }));
app.get('/auth/github/callback', 
  passport.authenticate('github', { failureRedirect: '/' }),
  (req, res) => {
    // 认证成功后跳转前端页面
    res.redirect('/');
  }
);

// 配置GraphQL类型定义和解析器
const typeDefs = `
  type Query {
    currentUser: User
  }
  type User {
    id: ID!
    username: String
    email: String
  }
`;

const resolvers = {
  Query: {
    currentUser: (_, __, { req }) => {
      // 从请求上下文获取已认证用户
      return req.user ? {
        id: req.user.id,
        username: req.user.username,
        email: req.user.emails[0].value
      } : null;
    }
  }
};

const server = new ApolloServer({ typeDefs, resolvers });

// 启动服务并挂载Apollo到Express
async function startServer() {
  await server.start();
  app.use('/graphql', express.json(), expressMiddleware(server, {
    context: async ({ req }) => ({ req })
  }));

  app.listen(4000, () => {
    console.log('服务运行在4000端口');
  });
}

startServer();

2. 能否将二者部署在单个端口？ #

完全可以。上面的示例代码已经实现了这一点：将Passport的认证路由和GraphQL端点都挂载到同一个Express服务器的4000端口，所有请求通过同一个端口处理，无需分开启动两个服务。

3. 同时开启两个端口会存在问题吗？ #

开发环境下不会有功能性问题，但生产环境不推荐，主要弊端：

• 跨域复杂度提升：前端同时访问两个端口时，需要额外配置CORS规则，增加调试和维护成本
• 部署运维麻烦：生产环境需配置反向代理（如Nginx）转发两个端口的请求，或单独管理两个服务进程，增加运维负担
• 会话共享问题：两个独立服务默认无法共享会话，需额外配置分布式会话存储（如Redis），否则GraphQL服务无法获取用户认证状态

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