07.8 阶段 7:全栈同构、部署与生产化
所属:全栈开发面试题库 / 学习路径 / 07 Node.js 全栈
本页目录
一、阶段定位
前六个阶段把服务从语言到数据层、安全、可观测都搭好了,但它还跑在你本机。本阶段解决两件事:第一,Node 作为 BFF 与全栈同构层,怎么与前端、与下游 Java/Go 后端分工;第二,怎么把它容器化、优雅退出、健康检查、灰度回滚地部署到生产。这是从"能跑"到"能上线"的最后一步。
与前后阶段的衔接:往上接 阶段 6 鉴权、安全、测试与可观测,日志与指标要在容器里收集;往下接 阶段 8 进阶方向(可选),那是本阶段之上的方向拓展。
本阶段原有的四个卡点,展开成可判断的现象依据:
- 把 BFF 当成又一个业务后端,重复实现业务规则。判断标准:BFF 层写了订单计算、库存扣减逻辑,与 Java/Go 后端重复;下游一改业务规则,BFF 也要改。
- 容器里仍用 PM2 做进程守护,职责重叠。判断标准:Dockerfile 里
CMD ["pm2-runtime", "app.js"],但容器本身就是一个进程单元,PM2 再守护一层。 - 收到退出信号直接杀掉进程导致在途请求中断。判断标准:部署时正在传输的请求 502,或日志显示连接被 reset;没监听 SIGTERM、没排空连接。
- 镜像里残留源码与开发依赖导致体积过大。判断标准:
docker images显示镜像 1GB+,里面有 node_modules、.git、src 源码。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能用 Next.js/Nuxt 写一个 BFF 接口,聚合下游多个服务 | 一次请求返回聚合数据 |
| 能写 Dockerfile 多阶段构建,镜像不含开发依赖 | docker images 体积小,运行正常 |
| 能监听 SIGTERM,排空在途连接再退出 | 发 SIGTERM 后在途请求完成,不 502 |
| 能配健康检查端点 | curl /health 返回 200,容器探针通过 |
| 能说清 PM2 与容器的取舍 | 生产容器用 node 直接起,不用 PM2 |
| 能描述灰度发布与回滚流程 | 回滚演练一次,新版本切旧版本成功 |
建议学时:
- 全职(每天 4–6 小时):2 周,约 55 小时。BFF 与 SSR 15 小时、Docker 15 小时、优雅退出与健康检查 10 小时、CI/CD 与灰度 15 小时。
- 在职(每天 2 小时):5 周。
学时分配建议:BFF/SSR 25%、Docker 多阶段 25%、优雅退出与健康检查 20%、CI/CD 灰度 20%、PM2 vs 容器 10%。
三、先修自检
| 先修项 | 合格标准 | 不合格时回到 |
|---|---|---|
| Express/NestJS | 能写服务 | 07.5 阶段 4 |
| 可观测 | 配 pino 与 OTel | 07.7 阶段 6 |
| Docker 基础 | 会 build、run | 08.1 容器化 |
| HTTP | 知道请求响应 | 01.2 计算机网络 |
| Git | 会提交 | 07.1 阶段 0 |
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| BFF | Next.js/Nuxt、SSR/ISR、流式渲染、Server Actions | 会用 | 03.7 SSR/SSG 与全栈前端 |
| 网关层 | 聚合、鉴权、限流、与下游分工 | 能讲清原理 | 09.2 流量治理 |
| Docker | 多阶段构建、distroless、.dockerignore | 会用 | 08.1 容器化 |
| 优雅退出 | SIGTERM、连接排空、server.close | 能讲清原理 | 08.4 CI/CD 与可观测性 |
| 健康检查 | liveness/readiness、/health | 会用 | 08.4 CI/CD 与可观测性 |
| 多核利用 | cluster、worker_threads | 会用 | 04.2 Node.js |
| CI/CD | 流水线、测试门禁、灰度、回滚 | 会用 | 08.4 CI/CD 与可观测性 |
| 综合 | 全链路方案、故障排查 | 了解 | 11.1 全链路设计 |
进度管理建议:BFF 分工、Docker 多阶段、优雅退出必须到"能讲清原理",其余到"会用"。
五、分模块精讲
5.1 BFF 与 Next.js/Nuxt SSR/ISR
为什么需要它:面向终端用户的页面,浏览器直连多个后端会慢、跨域麻烦、鉴权分散。BFF(Backend For Frontend)按页面视图聚合下游接口,SSR/ISR 提升首屏速度与 SEO。
核心机制:
- BFF 职责:按页面视图聚合下游接口、做鉴权、限流、裁剪字段;不写业务规则(订单计算、库存扣减仍在 Java/Go 后端)。
- SSR:服务端渲染 HTML,首屏快、SEO 好。
- ISR:静态生成 + 增量再生成,兼顾速度与新鲜度。
- 流式渲染:边渲染边下发,用户感知更快。
- Server Actions:Next.js App Router 的服务端函数,直接被前端调用,省掉手写 API 路由。
最小可运行示例:
// Next.js App Router:BFF 聚合
import { getUser, getOrders } from "@/lib/downstream";
export default async function UserPage({ params }) {
// 一次请求内并行调两个下游
const [user, orders] = await Promise.all([
getUser(params.id),
getOrders(params.id)
]);
return (
<div>
<h1>{user.name}</h1>
<ul>{orders.map(o => <li key={o.id}>{o.title}</li>)}</ul>
</div>
);
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| BFF 重复业务逻辑 | 写成第二个后端 | 只做聚合,业务下沉到下游 |
| SSR 慢 | 串行调下游 | Promise.all 并行 |
| ISR 数据不新鲜 | 缓存太久 | 设 revalidate 时间 |
面试考法:"BFF 与业务后端分工""SSR 与 CSR 区别"。答到聚合 vs 业务;首屏与 SEO。
5.2 网关层职责与 Node 与 Java/Go 分工
为什么需要它:不是所有服务都用 Node。CPU 密集、高并发中间件用 Java/Go,Node 适合 IO 密集、有大量 JS 生态复用的 BFF 与工具链。
核心机制:
- 网关层:统一入口,做鉴权、限流、路由、日志、协议转换。
- BFF:面向特定前端(Web/移动),聚合下游。
- Node 适合:BFF、SSR、工具链、CLI、IO 密集业务接口。
- Java/Go 适合:核心交易、高并发中间件、CPU 密集计算。
最小可运行示例:
请求 → 网关(Nginx/APISIX) → BFF(Node) → 业务后端(Java/Go) → DB
↘ 静态资源
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| Node 服务扛不住 CPU 任务 | 单线程 | 挪到 Java/Go 或 worker_threads |
| BFF 直接写库 | 越界 | 走下游业务后端 |
面试考法:"Node 与 Java/Go 怎么选"。答到 IO 密集 vs CPU 密集、生态复用。
5.3 Docker 多阶段构建与 distroless
为什么需要它:单阶段构建会把源码、node_modules、开发工具全打进镜像,体积大、有安全面。多阶段构建让最终镜像只含运行产物。
核心机制:
- 阶段 1(builder):装全部依赖、构建(tsc/tsup)。
- 阶段 2(runner):只装生产依赖、拷产物、用非 root 用户跑。
- distroless:Google 的精简基础镜像,只有运行时,没有 shell 与包管理器,攻击面小。
.dockerignore:排除 node_modules、.git、dist。
最小可运行示例:
# 阶段 1:builder
FROM node:20-slim AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
# 阶段 2:runner
FROM node:20-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY --from=builder /app/dist ./dist
USER node
EXPOSE 3000
CMD ["node", "dist/app.js"]
docker build -t my-app .
docker images my-app # 体积应在 200-300MB
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 镜像 1GB+ | 单阶段含全部依赖 | 多阶段构建 |
| 容器里有 shell | 用了 slim 或 alpine | 换 distroless |
| 以 root 跑 | 安全风险 | 加 USER node |
| .git 进镜像 | 没 .dockerignore | 加排除 |
面试考法:"多阶段构建解决什么""为什么用 distroless"。答到体积与攻击面;只含运行时。
5.4 优雅退出:SIGTERM 与连接排空
为什么需要它:容器收到 SIGTERM 后默认 10 秒内强杀进程,正在处理的请求会 502。要监听信号、停止接收新请求、排空在途连接。
核心机制:
- K8s/容器发 SIGTERM 通知进程要退出。
server.close():停止接受新连接,等在途请求完成。- 设超时(如 10 秒),超时强杀。
- 同时关闭 DB 连接、Redis 连接、队列 worker。
最小可运行示例:
const server = app.listen(3000);
async function shutdown(signal) {
console.log(`收到 ${signal},开始优雅退出`);
server.close((err) => {
if (err) { console.error(err); process.exit(1); }
// 关 DB、Redis、队列
prisma.$disconnect();
redis.disconnect();
console.log("已排空,退出");
process.exit(0);
});
// 超时强杀
setTimeout(() => process.exit(1), 10000).unref();
}
process.on("SIGTERM", () => shutdown("SIGTERM"));
process.on("SIGINT", () => shutdown("SIGINT"));
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 部署时在途请求 502 | 没监听 SIGTERM | 加 server.close |
| 退出时 DB 连接未关 | 只关了 HTTP | 同时关 DB/Redis |
| 卡在退出 | 有未关闭句柄 | 加超时强杀 |
面试考法:"容器怎么优雅退出""SIGTERM 与 SIGKILL 区别"。答到信号通知、排空连接;SIGKILL 不可捕获。
5.5 健康检查与多核利用
为什么需要它:编排系统要知道容器是否活着、是否就绪。多核机器要跑满 CPU。
核心机制:
- liveness 探针:进程死了重启。
- readiness 探针:没准备好不接流量。
/health端点:返回 200,检查 DB/Redis 连通性。- 多核利用:cluster 起多个 worker(或容器多副本,更简单)。
- 生产更推荐容器多副本而非 cluster,因为编排系统已经管了。
最小可运行示例:
app.get("/health", async (req, res) => {
try {
await prisma.$queryRaw`SELECT 1`;
await redis.ping();
res.json({ status: "ok" });
} catch {
res.status(503).json({ status: "degraded" });
}
});
# K8s 探针示例
livenessProbe:
httpGet: { path: /health, port: 3000 }
initialDelaySeconds: 10
readinessProbe:
httpGet: { path: /health, port: 3000 }
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 容器反复重启 | liveness 失败 | 看 /health 返回 |
| 流量打到未就绪实例 | 没 readiness | 加探针 |
面试考法:"liveness 与 readiness 区别""为什么容器里不用 cluster"。答到重启 vs 摘流;多副本更简单。
5.6 PM2 vs 容器、CI/CD 与灰度回滚
为什么需要它:单机用 PM2,生产容器里不该再用 PM2。CI/CD 自动化测试、构建、部署;灰度让新版本逐步放量。
核心机制:
- PM2:单机进程守护、集群模式、日志轮转。适合单机部署。
- 容器里:一个容器一个进程,直接
node app.js,PM2 多余。 - CI/CD:push → 测试 → 构建镜像 → 推送 registry → 部署。
- 灰度:新版本先放 10% 流量,观察指标,逐步到 100%。
- 回滚:新版本有问题,切回旧版本镜像/标签。
最小可运行示例:
# 单机 PM2
pm2 start app.js -i max
pm2 logs
pm2 restart app
# 容器里直接 node
docker run my-app node dist/app.js
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 容器里 PM2 多此一举 | 职责重叠 | 直接 node |
| 回滚慢 | 镜像没打标签 | 用 git sha 做 tag,秒切 |
面试考法:"PM2 与 Docker 怎么选""灰度发布流程"。答到单机 vs 容器;逐步放量、指标观察。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| BFF 聚合 | Next.js 页面并行调两个下游 | 一次请求返回聚合数据 | 2 小时 |
| 多阶段 Dockerfile | 写 builder + runner | 镜像体积 < 300MB | 1.5 小时 |
| 优雅退出 | 监听 SIGTERM,server.close | 在途请求完成再退出 | 1.5 小时 |
| 健康检查 | /health 查 DB 与 Redis | 依赖挂时返回 503 | 1 小时 |
| 非 root 跑 | Dockerfile 加 USER node | 容器里是 node 用户 | 0.5 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 单阶段改多阶段 | 给定 1GB 镜像,改成多阶段 | 体积降到 200MB | 1.5 小时 |
| 加优雅退出 | 给定直接 process.exit 的代码,改成排空 | 部署时无 502 | 1.5 小时 |
| 去 PM2 | 给定 Dockerfile 用 pm2-runtime,改成直接 node | 职责清晰 | 0.5 小时 |
| BFF 瘦身 | 给定 BFF 里重复业务逻辑,下沉到下游 | BFF 只聚合 | 2 小时 |
| 加 readiness | 给定只有 liveness 的探针,加 readiness | 未就绪不接流量 | 1 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 完整部署流水线 | CI 跑测试→构建镜像→部署 | 每次 push 自动发布 | 4 小时 |
| 灰度方案 | 设计 10%→50%→100% 放量与回滚 | 回滚演练成功 | 3 小时 |
| 压测报告 | 压测记录 QPS/P95/P99/内存 | 报告可读 | 3 小时 |
| 全链路图 | 画请求从网关到 DB 的完整链路 | 标注各层职责与故障点 | 2 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
| 部署时 502 | 没优雅退出 | 看容器日志 | 加 SIGTERM 处理 |
| 镜像 1GB+ | 单阶段构建 | docker history 看层 | 多阶段构建 |
| 容器反复重启 | liveness 失败 | curl /health | 修依赖或调探针 |
| 流量打到坏实例 | 没 readiness | 看 K8s 事件 | 加 readiness 探针 |
| BFF 重复业务 | 职责不清 | 看代码 | 业务下沉到下游 |
| 退出卡住 | 有未关闭句柄 | 看日志 | 加超时强杀 |
| 容器以 root 跑 | 安全风险 | 看 Dockerfile | 加 USER node |
| 回滚慢 | 镜像没标签 | 看 registry | 用 git sha 打 tag |
八、出口条件
全部勾选后再进入 阶段 8 进阶方向(可选)。
- [ ] 能用 Next.js/Nuxt 写 BFF 聚合下游,说清与业务后端分工
- [ ] 能写多阶段 Dockerfile,镜像不含开发依赖与源码
- [ ] 能监听 SIGTERM,server.close 排空在途连接
- [ ] 能配 /health 健康检查,区分 liveness 与 readiness
- [ ] 能说清 PM2 与容器的取舍,生产容器直接 node 起
- [ ] 能描述灰度发布与回滚流程,演练一次回滚
- [ ] 能解释 Node 与 Java/Go 的分工场景
- [ ] 排障表八个现象,随机抽三个能在 5 分钟内给出排查路径
自测题:
- BFF 与业务后端的边界在哪?
- 要点:BFF 做聚合、鉴权、限流、字段裁剪;业务规则下沉到下游。
- Docker 多阶段构建解决什么?
- 要点:最终镜像只含运行产物,体积小、攻击面小。
- 容器收到 SIGTERM 后怎么优雅退出?
- 要点:停止接收新请求,server.close 排空在途,关闭 DB/Redis,超时强杀。
- liveness 与 readiness 区别?
- 要点:liveness 死了重启,readiness 没准备好不接流量。
- 为什么容器里不推荐 PM2?
- 要点:一个容器一个进程,编排系统已管进程;PM2 多余。
- 灰度发布怎么放量?
- 要点:10%→50%→100%,观察指标,有问题回滚。
- Node 与 Java/Go 怎么选?
- 要点:IO 密集、JS 生态复用选 Node;CPU 密集、高并发中间件选 Java/Go。