Express on PlumePHP

Node.js JWT 认证实战：Express + Passport 的登录鉴权与权限控制

Sat, 22 Nov 2025 18:00:00 +0800

JWT（JSON Web Token）是现代 Web 应用的标准认证方案：无状态、自包含、可跨域。本文详解 Node.js 后端 JWT 认证的完整实现。

一、JWT 基础

JWT 由三部分组成：Header.Payload.Signature

Express.js 完全指南：路由、中间件与 REST API 开发实战

Sat, 22 Nov 2025 15:00:00 +0800

Express.js 是 Node.js 生态中最流行、最轻量的 Web 框架，自 2010 年发布以来一直是构建 REST API 和 Web 应用的首选。本文从路由到中间件，从开发到生产，覆盖 Express 的完整实战路径。

一、项目初始化

mkdir my-api && cd my-api
npm init -y
npm install express
npm install -D nodemon @types/express typescript ts-node

npx tsc --init

// src/index.ts
import express, { Request, Response } from 'express';

const app = express();
app.use(express.json());

app.get('/', (req: Request, res: Response) => {
 res.json({ message: 'Hello Express' });
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => console.log(`Server running on port ${PORT}`));

二、路由系统

import { Router } from 'express';

const userRouter = Router();

// 参数路由
userRouter.get('/:id', (req, res) => {
 res.json({ id: req.params.id });
});

// 查询参数
userRouter.get('/', (req, res) => {
 const { page = '1', limit = '10' } = req.query;
 res.json({ page, limit });
});

// POST 请求体
userRouter.post('/', (req, res) => {
 const { name, email } = req.body;
 res.status(201).json({ id: 1, name, email });
});

app.use('/users', userRouter);

三、中间件

// 日志中间件
app.use((req, res, next) => {
 console.log(`${req.method} ${req.url}`);
 next();
});

// 错误处理中间件（必须放在最后）
app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
 console.error(err.stack);
 res.status(500).json({ error: 'Something broke!' });
});

四、项目结构

src/
├── index.ts # 入口
├── routes/
│ ├── users.ts
│ └── posts.ts
├── controllers/
│ ├── userController.ts
│ └── postController.ts
├── middleware/
│ ├── auth.ts
│ ├── errorHandler.ts
│ └── validate.ts
├── models/
│ └── user.ts
└── utils/
 └── db.ts

常见问题

Express 5 什么时候发布？

Express 5 目前处于 RC 阶段，主要改进是原生支持 async 错误处理（不再需要 express-async-errors 包）。

TypeScript + Node.js 后端工程化：Express / Nest.js 的类型安全实践

Sat, 22 Nov 2025 13:00:00 +0800

用 TypeScript 编写 Node.js 后端可以大幅提升可维护性和开发效率。本文覆盖 TS + Node 的工程化全流程。

一、项目初始化

mkdir my-api && cd my-api
npm init -y
npm install -D typescript ts-node nodemon @types/node
npx tsc --init

// tsconfig.json
{
 "compilerOptions": {
 "target": "ES2022",
 "module": "CommonJS",
 "outDir": "./dist",
 "rootDir": "./src",
 "strict": true,
 "esModuleInterop": true,
 "skipLibCheck": true,
 "resolveJsonModule": true,
 "baseUrl": ".",
 "paths": { "@/*": ["src/*"] }
 }
}

二、Express + TS

import express, { Request, Response } from 'express';

const app = express();

interface User {
 id: number;
 name: string;
}

app.get('/users/:id', (req: Request<{ id: string }>, res: Response<User>) => {
 const user: User = { id: Number(req.params.id), name: 'Alice' };
 res.json(user);
});

app.listen(3000);

三、Nest.js（推荐企业级）

Nest.js 原生基于 TypeScript 设计，是 Node.js 的 Angular 式框架：

Docker 部署 Node.js：Express / Nest.js 后端服务的容器化实战

Sat, 22 Nov 2025 06:00:00 +0800

将 Node.js 应用 Docker 化是生产部署的最佳实践：保证开发/生产环境一致、简化部署流程、方便扩缩容。本文覆盖 Express、Nest.js、Fastify 三大主流框架的容器化方案。