18 NestJS 基于 Docker 的 NestJS + Prisma + Playwright 生产环境容器化实践

前言

本文以我最近开发的实际工程项目（NestJS 服务端 + Prisma 7 ORM + Playwright 无头浏览器爬虫）为背景，详细阐述从“本地开发环境”迁移到“生产级 Docker 容器化环境”的标准实施路径与典型排错过程。

探讨重点在于多阶段构建（Multi-stage Build）、复杂依赖隔离、环境变量规范化、运行时脚本执行拓扑，以及容器进程生命周期管理。

1. 开发环境与容器运行时的差异剖析

在本地开发阶段，开发机往往经过长期配置，环境相对宽容：

pnpm install          # 安装全部依赖（包含 devDependencies）
pnpm start:dev        # 借助 dotenv 注入 .env.development 并启动热重载

然而，Docker 容器是一个最小化、无状态且隔离的纯净 Linux 环境。与宿主开发机相比，容器通常缺少：

• 本地持久化的环境变量配置文件（如 .env.development）；
• 全局安装的构建与执行工具链（pnpm、prisma CLI、tsx 等）；
• Chromium 等无头浏览器及其底层的系统共享库（libnss3、libatk、libgbm 等）；
• 编译 Node.js 原生扩展（C/C++ 原生模块，如 @node-rs/argon2）所需的系统编译工具链（gcc、make、python 等）。

因此，容器化构建的本质，在于通过声明式配置（Dockerfile），以可重现（Reproducible）的方式将应用及其运行所需的软硬件依赖完整固化为轻量级镜像。在此过程中，本地环境中被掩盖的隐式依赖和环境耦合都会逐一显现。