前言
本文以我最近开发的实际工程项目（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）的方式将应用及其运行所需的软硬件依赖完整固化为轻量级镜像。在此过程中，本地环境中被掩盖的隐式依赖和环境耦合都会逐一显现。
此处内容已隐藏回复后方可阅读。