React / 系统课时

实现用户登录

实现用户登录

这一节实现一个完整的密码登录接口:服务端根据邮箱读取用户、用常量时间比较验证 scrypt 哈希,验证成功后签发短期会话 JWT,并通过 HttpOnly Cookie 返回浏览器。最终结果不是“密码匹配就算完成”,而是得到一个后续请求可以携带的受签名登录会话。

学习目标

  • 在服务端完成凭据校验、用户查询和密码哈希比对。
  • 使用签名 JWT 表示会话,并把它写入安全属性明确的 Cookie。
  • 用成功与失败请求验证状态码、响应体和 Set-Cookie 行为。

准备登录所需的数据与密钥

本例沿用一个包含 id、email 和 password_hash 的 PostgreSQL 用户表,其中 password_hash 必须采用 scrypt$<SALT>$<HASH> 格式。若数据库还没有用户,应先通过注册接口或等价的后台流程创建,不能手工写入明文密码。

安装依赖:

bash
pnpm add jose postgres zod

预期输出:

text
Packages: +<VALUE>
Done in <TIME>

再为会话签名准备高熵密钥,并放入仅服务端可读取的环境变量:

bash
openssl rand -base64 32

预期输出:

text
<VALUE>

把实际生成值配置为 SESSION_SECRET,不要提交到 Git。生产环境应由部署平台的 Secret 管理能力注入。

串起身份验证与会话创建

登录链路同时涉及请求输入、数据库、密码哈希和浏览器 Cookie。先看清数据如何流动,再写代码更不容易把“身份验证”和“会话保存”混在一起。

用户登录、密码验证与会话签发时序

创建 app/api/login/route.ts:

ts
import { scrypt, timingSafeEqual } from 'node:crypto';
import { SignJWT } from 'jose';
import { NextResponse } from 'next/server';
import postgres from 'postgres';
import { z } from 'zod';

export const runtime = 'nodejs';

const sql = postgres(process.env.POSTGRES_URL!);

const LoginSchema = z.object({
  email: z.string().trim().toLowerCase().email(),
  password: z.string().min(1).max(128),
});

function scryptAsync(password: string, salt: string, length: number) {
  return new Promise<Buffer>((resolve, reject) => {
    scrypt(password, salt, length, (error, derivedKey) => {
      if (error) reject(error);
      else resolve(derivedKey);
    });
  });
}

async function verifyPassword(password: string, encoded: string) {
  const [algorithm, salt, storedHex] = encoded.split('$');
  if (algorithm !== 'scrypt' || !salt || !storedHex) return false;

  const stored = Buffer.from(storedHex, 'hex');
  if (stored.length === 0) return false;

  const candidate = await scryptAsync(password, salt, stored.length);
  return timingSafeEqual(stored, candidate);
}

export async function POST(request: Request) {
  const body = await request.json().catch(() => null);
  const parsed = LoginSchema.safeParse(body);

  if (!parsed.success) {
    return NextResponse.json({ error: 'validation_error' }, { status: 400 });
  }

  const [user] = await sql<{
    id: string;
    email: string;
    password_hash: string;
  }[]>`
    SELECT id, email, password_hash
    FROM users
    WHERE email = ${parsed.data.email}
    LIMIT 1
  `;

  const valid = user
    ? await verifyPassword(parsed.data.password, user.password_hash)
    : false;

  if (!valid) {
    return NextResponse.json(
      { error: 'invalid_credentials' },
      { status: 401 },
    );
  }

  const secret = process.env.SESSION_SECRET;
  if (!secret) {
    console.error('SESSION_SECRET is not configured');
    return NextResponse.json({ error: 'internal_error' }, { status: 500 });
  }

  const token = await new SignJWT({ email: user.email })
    .setProtectedHeader({ alg: 'HS256' })
    .setSubject(user.id)
    .setIssuedAt()
    .setExpirationTime('7d')
    .sign(new TextEncoder().encode(secret));

  const response = NextResponse.json({ ok: true }, { status: 200 });
  response.cookies.set({
    name: 'session',
    value: token,
    httpOnly: true,
    secure: process.env.NODE_ENV === 'production',
    sameSite: 'lax',
    path: '/',
    maxAge: 60 * 60 * 24 * 7,
  });

  return response;
}

预期结果:

text
凭据正确:200 OK,并返回 Set-Cookie: session=<VALUE>
凭据错误:401 Unauthorized,响应体为 {"error":"invalid_credentials"}
输入格式错误:400 Bad Request,响应体为 {"error":"validation_error"}

用户不存在和密码错误使用同一个 401 invalid_credentials,避免接口通过响应差异泄露账号是否存在。

用真实请求验证成功与失败分支

先使用数据库中已经注册的账号发起登录,并用 -i 查看响应头:

bash
curl -i -X POST http://localhost:3000/api/login -H 'Content-Type: application/json' -d '{"email":"ada@example.com","password":"correct-horse-battery"}'

预期输出:

text
HTTP/1.1 200 OK
Set-Cookie: session=<VALUE>; Path=/; HttpOnly; SameSite=lax
Content-Type: application/json
...

{"ok":true}

开发环境不会设置 Secure;生产环境通过 HTTPS 运行时会设置。再把密码改错:

bash
curl -i -X POST http://localhost:3000/api/login -H 'Content-Type: application/json' -d '{"email":"ada@example.com","password":"wrong-password"}'

预期输出:

text
HTTP/1.1 401 Unauthorized
Content-Type: application/json
...

{"error":"invalid_credentials"}

响应头顺序、JWT 内容和其他动态字段可能不同。登录成功后,受保护页面还需要在服务端验证 session 的签名、过期时间和 sub,不能只检查 Cookie 是否存在。实际生产系统通常还会增加登录速率限制、会话撤销、退出登录、密码重置和多因素认证;这些能力属于会话生命周期与账号安全层,不应通过弱化密码验证来简化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现用户登录

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通