Session、JWT 与 Token 认证机制

创建并验证会话凭据和 JWT,并判断两种机制的取舍

🎯 引言

学完这篇文章,你能创建并验证会话凭据和 JWT,并判断两种机制的取舍。

🎫 Token 是凭据,JWT 是一种格式

Token 泛指客户端用来证明某种身份或资格的值。随机 Session ID 是 Token,JWT 也可以作为 Token。它们不是三个互斥选项。

Session 方案通常让客户端保存随机值,服务端按这个值查登录记录。JWT 通常携带签名后的声明,服务端验证签名及约束,再使用其中的用户标识。签名用于验证内容没有被不可信方篡改,不等于把内容加密。


🗃 使用 express-session 保存登录状态

Express 项目可以使用 express-session 管理会话。它读取会话 Cookie、查找服务端记录,并通过 req.session 提供当前会话。

安装本节需要的依赖:

npm install express-session@1.19.0

新建 session-app.mjs,准备应用和会话密钥:

session-app.mjs
import express from 'express';
import session from 'express-session';

export const app = express();
const secret = process.env.SESSION_SECRET;
if (!secret || Buffer.byteLength(secret) < 32) throw new Error('请配置会话密钥');

SESSION_SECRET 应是随机生成并保存在服务端的秘密值,用于保护会话 Cookie 的签名。可以用内置加密模块生成一次,将输出保存到本地 .env 的 SESSION_SECRET 中,不提交仓库:

session-secret.mjs
import { randomBytes } from 'node:crypto';

console.log(randomBytes(32).toString('hex'));

运行 node session-secret.mjs 会得到一段随机字符串。多个服务实例要使用一致的密钥,不能每次请求重新生成。


🍪 在路由前配置会话中间件

在 session-app.mjs 添加:

session-app.mjs
app.use(session({
    name: 'sid',
    secret,
    resave: false,
    saveUninitialized: false,
    cookie: { httpOnly: true, sameSite: 'lax', secure: false, maxAge: 30 * 60_000 }
}));

name 指定 Cookie 名称;resave: false 避免未修改时重复保存;saveUninitialized: false 避免为未使用会话的访问者写入记录。Cookie 有效期为 30 分钟,HttpOnly 限制页面脚本读取,SameSite 限制跨站携带。

secure: false 仅适用于本机 HTTP 练习。正式 HTTPS 服务设为 true;经过反向代理时,还应按实际部署配置 Express 对可信代理的识别。

默认存储只适合本地开发,重启会丢失记录。正式部署在 session 配置的 store 中接入共享存储,让多个进程都能读取同一份登录状态,并由存储清理过期会话。


✅ 验证密码后保存用户 ID

账号密码验证成功后,先重新生成会话 ID,再保存可信用户 ID。这样登录前的旧会话不能继续用于登录后的身份。

下面的函数用于登录成功这一步,res.locals.user 是前面的密码验证步骤查询并确认的用户记录,例如 { id: 1 },不能直接赋为请求正文:

login-success.mjs
export function loginSuccess(req, res, next) {
    req.session.regenerate(error => {
        if (error) return next(error);
        req.session.userId = res.locals.user.id;
        req.session.save(error => {
            if (error) return next(error);
            res.json({ data: { loggedIn: true } });
        });
    });
}

把这个处理函数放在登录路由完成密码验证之后执行。regenerate 更换会话,save 确认记录已保存,再返回成功;失败则交给错误中间件。浏览器收到 Set-Cookie 后保存 sid,以后的符合条件的请求会自动携带它。


🔎 业务接口读取登录身份

在会话中间件之后添加 /me:

session-app.mjs
app.get('/me', (req, res) => {
    if (!req.session.userId) {
        return res.status(401).json({ error: '请先登录' });
    }
    res.json({ data: { userId: req.session.userId } });
});

没有有效登录记录时得到 401。登录为用户 1 后,同一个浏览器请求会得到 {"data":{"userId":1}},用户 ID 来自服务端会话,而非客户端自己声明。


🚪 退出时删除服务端会话

继续添加退出接口:

session-app.mjs
app.post('/logout', (req, res, next) => {
    req.session.destroy(error => {
        if (error) return next(error);
        res.clearCookie('sid', { path: '/' });
        res.status(204).end();
    });
});

destroy 删除会话记录,clearCookie 通知浏览器删除对应 Cookie。成功返回 204,再请求 /me 就会得到 401。Cookie 认证的修改接口还需在修改前执行 CSRF 防护,具体做法见安全篇。


✍️ 使用库签发 JWT

在示例目录安装 JWT 库:

npm install jose@6.2.13

新建 tokens.mjs,准备签名密钥:

tokens.mjs
import { SignJWT, jwtVerify } from 'jose';
import { randomBytes } from 'node:crypto';

const key = randomBytes(32);

这是本地演示密钥,重启会变化。正式服务应从安全配置读取稳定密钥,并设计轮换;不能把密钥写进前端或源码仓库。

添加签发函数:

tokens.mjs
export function issueAccess(userId) {
    return new SignJWT({})
        .setProtectedHeader({ alg: 'HS256' })
        .setSubject(String(userId))
        .setIssuer('backend-demo')
        .setAudience('web-demo')
        .setExpirationTime('15m')
        .sign(key);
}

sub 标识用户,iss 限定签发者,aud 限定使用方,exp 限定有效期。这里使用 HS256,由持有同一秘密密钥的一方签发和验证;密钥泄露后别人也能伪造令牌。

JWT 内容可被读取,不要放密码、身份证件等秘密信息。


✅ 验证后才能使用声明

在同一文件添加:

tokens.mjs
export async function verifyAccess(token) {
    const { payload } = await jwtVerify(token, key, {
        algorithms: ['HS256'], issuer: 'backend-demo', audience: 'web-demo'
    });
    if (typeof payload.sub !== 'string') throw new Error('缺少用户标识');
    return payload.sub;
}

签名、算法、签发者、使用方或有效期不符合时会失败。仅解码载荷只能读取内容,不能证明内容可信。

新建 token-demo.mjs:

token-demo.mjs
import { issueAccess, verifyAccess } from './tokens.mjs';

const token = await issueAccess(1);
console.log(await verifyAccess(token));

运行后得到字符串 1。接口收到 Bearer 凭据后调用 verifyAccess,验证失败应转换为 401,成功后再检查权限。


⚖️ 按撤销和部署需求选择

Session 可以通过删除记录立即撤销,但每次需要查服务端状态。JWT 可以在验证签名后读取声明,但退出登录不会自动作废已发出的 JWT;若要求立即撤销,仍要增加服务端状态检查或使用较短有效期。

JWT 中保存的角色可能过时。敏感权限应结合当前用户状态判断,不能仅因为令牌签名有效就永久相信旧权限。


❓ 知识问答

Q1:JWT 比 Session 一定更安全吗?

不是。两者都依赖密钥或凭据保护、有效期、撤销机制和请求权限检查,格式本身不保证整体安全。

Q2:Token 能放 URL 中吗?

不应这样传登录凭据,URL 容易进入历史与日志。使用合适的认证头或受保护 Cookie。

Q3:一个服务只验证签名就够了吗?

不够,还要检查有效期、签发者、使用方、允许算法和所需声明,并进行实际授权。


🧪 小练习

在项目登录流程中接入会话保存与退出,确认退出后 /me 返回 401;将 JWT 验证端 audience 改为其他值,确认同一令牌不能通过。

// 请在这里编写代码或记录验证结果