Next.js 与 Next-Auth V5 实现 Social Logins

// 导入 NextAuth 和提供商
import NextAuth from "next-auth";
import GoogleProvider from "next-auth/providers/google";
import GitHubProvider from "next-auth/providers/github";

// 导出认证相关方法和对象
export const {
  handlers: { GET, POST }, // 用于 API 路由的处理器
  auth,                    // 获取会话信息的函数
  signIn,                  // 登录函数
  signOut,                 // 登出函数
} = NextAuth({
  // 配置认证提供商
  providers: [
    // 这里将添加 Google 和 GitHub 提供商配置
  ],
  
  // 可选：自定义页面路径
  pages: {
    signIn: '/auth/signin',    // 自定义登录页面
    error: '/auth/error',      // 错误显示页面
  },
  
  // 会话配置
  session: {
    strategy: 'jwt',           // 使用 JWT 作为会话策略
    maxAge: 30 * 24 * 60 * 60, // 30天会话有效期
  },
  
  // 回调函数
  callbacks: {
    async jwt({ token, user, account }) {
      // 在 JWT 令牌创建或更新时调用
      if (user) {
        token.id = user.id; // 将用户ID添加到令牌
      }
      if (account) {
        token.accessToken = account.access_token; // 添加访问令牌
      }
      return token;
    },
    
    async session({ session, token }) {
      // 在会话创建时调用
      if (session?.user) {
        session.user.id = token.id; // 将用户ID添加到会话
      }
      return session;
    },
  },
});

// 从 auth.js 导入 GET 和 POST 处理器
export { GET, POST } from "@/auth";

// 服务器操作指令
'use server'

// 导入 Next-Auth 的登录和登出方法
import { signIn, signOut } from "@/auth";

/**
 * 处理Social Login的服务器操作
 * @param {FormData} formData - 表单数据
 */
export async function doSocialLogin(formData) {
  // 获取操作类型（google 或 github）
  const action = formData.get('action');
  
  try {
    // 调用 Next-Auth 的 signIn 方法
    await signIn(action, { 
      redirectTo: "/home", // 登录成功后重定向到首页
    });
  } catch (error) {
    // 处理登录错误
    console.error('登录错误:', error);
    throw new Error('登录失败，请稍后重试');
  }
}

/**
 * 处理用户登出的服务器操作
 */
export async function doLogout() {
  try {
    // 调用 Next-Auth 的 signOut 方法
    await signOut({ 
      redirectTo: "/", // 登出后重定向到根路径
    });
  } catch (error) {
    // 处理登出错误
    console.error('登出错误:', error);
    throw new Error('登出失败，请稍后重试');
  }
}

/**
 * 获取当前用户会话信息
 * @returns {Promise<Object>} 会话信息
 */
export async function getSession() {
  // 导入 auth 函数
  const { auth } = await import('@/auth');
  
  // 获取当前会话
  const session = await auth();
  
  return session;
}

import NextAuth from "next-auth";
import GoogleProvider from "next-auth/providers/google";

export const {
  handlers: { GET, POST },
  auth,
  signIn,
  signOut,
} = NextAuth({
  providers: [
    GoogleProvider({
      clientId: process.env.GOOGLE_CLIENT_ID,
      clientSecret: process.env.GOOGLE_CLIENT_SECRET,
      authorization: {
        params: {
          prompt: "consent",        // 每次登录都要求用户同意
          access_type: "offline",   // 获取刷新令牌
          response_type: "code",    // 使用授权码流程
        },
      },
      // 配置用户资料映射
      profile(profile) {
        return {
          id: profile.sub,
          name: profile.name,
          email: profile.email,
          image: profile.picture,
        };
      },
    }),
  ],
});

import NextAuth from "next-auth";
import GoogleProvider from "next-auth/providers/google";
import GitHubProvider from "next-auth/providers/github";

export const {
  handlers: { GET, POST },
  auth,
  signIn,
  signOut,
} = NextAuth({
  providers: [
    GoogleProvider({
      // ... Google 配置保持不变
    }),
    GitHubProvider({
      clientId: process.env.GITHUB_CLIENT_ID,
      clientSecret: process.env.GITHUB_CLIENT_SECRET,
      authorization: {
        params: {
          prompt: "consent",
          access_type: "offline",
          response_type: "code",
        },
      },
      // 配置用户资料映射
      profile(profile) {
        return {
          id: profile.id.toString(),
          name: profile.name || profile.login,
          email: profile.email,
          image: profile.avatar_url,
        };
      },
    }),
  ],
});

/** @type {import('next').NextConfig} */
const nextConfig = {
  images: {
    remotePatterns: [
      {
        protocol: 'https',
        hostname: 'lh3.googleusercontent.com', // Google 头像域名
      },
      {
        protocol: 'https',
        hostname: 'avatars.githubusercontent.com', // GitHub 头像域名
      },
    ],
  },
};

export default nextConfig;

export const {
  // ... 导出保持不变
} = NextAuth({
  // ... 提供商配置保持不变
  
  // 安全相关配置
  cookies: {
    sessionToken: {
      name: `next-auth.session-token`,
      options: {
        httpOnly: true,    // 防止XSS攻击
        sameSite: 'lax',   // CSRF保护
        path: '/',
        secure: process.env.NODE_ENV === 'production', // 仅在生产环境使用HTTPS
      },
    },
  },
  
  // 高级安全配置
  advanced: {
    // 启用服务器端会话管理
    useSecureCookies: process.env.NODE_ENV === 'production',
  },
});

// lib/env.js
/**
 * 验证必需的环境变量
 * @param {Array} requiredVars - 必需的环境变量名称数组
 */
export function validateEnv(requiredVars) {
  const missingVars = requiredVars.filter(varName => !process.env[varName]);
  
  if (missingVars.length > 0) {
    throw new Error(`缺少必需的环境变量: ${missingVars.join(', ')}`);
  }
}

// 在应用启动时验证环境变量
validateEnv(['AUTH_SECRET', 'GOOGLE_CLIENT_ID', 'GOOGLE_CLIENT_SECRET', 'GITHUB_CLIENT_ID', 'GITHUB_CLIENT_SECRET']);

// middleware/errorHandler.js
/**
 * 认证错误处理中间件
 */
export function withAuthErrorHandling(handler) {
  return async (req, res) => {
    try {
      return await handler(req, res);
    } catch (error) {
      console.error('认证错误:', error);
      
      // 根据错误类型返回不同的错误页面
      if (error.type === 'CredentialsSignin') {
        return res.redirect('/auth/error?error=CredentialsSignin');
      }
      
      return res.redirect('/auth/error?error=UnknownError');
    }
  };
}