罗罗编程学习记录
本页内容 展开查看

07.8 阶段 7:全栈同构、部署与生产化

所属:全栈开发面试题库 / 学习路径 / 07 Node.js 全栈

本页目录

一、阶段定位

前六个阶段把服务从语言到数据层、安全、可观测都搭好了,但它还跑在你本机。本阶段解决两件事:第一,Node 作为 BFF 与全栈同构层,怎么与前端、与下游 Java/Go 后端分工;第二,怎么把它容器化、优雅退出、健康检查、灰度回滚地部署到生产。这是从"能跑"到"能上线"的最后一步。

与前后阶段的衔接:往上接 阶段 6 鉴权、安全、测试与可观测,日志与指标要在容器里收集;往下接 阶段 8 进阶方向(可选),那是本阶段之上的方向拓展。

本阶段原有的四个卡点,展开成可判断的现象依据:

  1. 把 BFF 当成又一个业务后端,重复实现业务规则。判断标准:BFF 层写了订单计算、库存扣减逻辑,与 Java/Go 后端重复;下游一改业务规则,BFF 也要改。
  2. 容器里仍用 PM2 做进程守护,职责重叠。判断标准:Dockerfile 里 CMD ["pm2-runtime", "app.js"],但容器本身就是一个进程单元,PM2 再守护一层。
  3. 收到退出信号直接杀掉进程导致在途请求中断。判断标准:部署时正在传输的请求 502,或日志显示连接被 reset;没监听 SIGTERM、没排空连接。
  4. 镜像里残留源码与开发依赖导致体积过大。判断标准: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 分钟内给出排查路径

自测题:

  1. BFF 与业务后端的边界在哪?
    • 要点:BFF 做聚合、鉴权、限流、字段裁剪;业务规则下沉到下游。
  2. Docker 多阶段构建解决什么?
    • 要点:最终镜像只含运行产物,体积小、攻击面小。
  3. 容器收到 SIGTERM 后怎么优雅退出?
    • 要点:停止接收新请求,server.close 排空在途,关闭 DB/Redis,超时强杀。
  4. liveness 与 readiness 区别?
    • 要点:liveness 死了重启,readiness 没准备好不接流量。
  5. 为什么容器里不推荐 PM2?
    • 要点:一个容器一个进程,编排系统已管进程;PM2 多余。
  6. 灰度发布怎么放量?
    • 要点:10%→50%→100%,观察指标,有问题回滚。
  7. Node 与 Java/Go 怎么选?
    • 要点:IO 密集、JS 生态复用选 Node;CPU 密集、高并发中间件选 Java/Go。