Docker构建中TSC命令执行失败，寻求解决方案

核心问题拆解 #

• 依赖不全：你在deps阶段用pnpm i --prod只装了生产依赖，但TypeScript和构建相关工具（比如类型定义包）都属于devDependencies，完全没被安装。后面临时用yarn add typescript不仅混用了包管理器，还会漏掉其他必要的构建依赖。
• NODE_ENV设置时机错误：builder阶段提前把NODE_ENV设为production，包管理器会自动跳过开发依赖安装，就算手动装了typescript，其他关键依赖还是缺失。
• 包管理器混用：一会儿用pnpm装依赖，一会儿用yarn加包，会导致依赖树混乱，引发各种不可预知的构建问题。
• 阶段依赖断档：binaries-deps继承的是deps的生产依赖，传到builder阶段后，构建需要的开发依赖完全缺失。

修复后的Dockerfile #

## 安装全量依赖（生产+开发） ##
#################################
FROM node:18-alpine AS deps
RUN apk add --no-cache libc6-compat

WORKDIR /app

# 启用pnpm，替代全局安装方式
RUN corepack enable pnpm

# 复制依赖配置文件
COPY package*.json pnpm-lock.yaml* ./

# 安装所有依赖，包含构建所需的devDependencies
RUN pnpm install

####################
## 生成Prisma客户端 ##
####################
FROM --platform=amd64 node:18-alpine AS binaries-deps
RUN apk add --no-cache libc6-compat
RUN corepack enable pnpm

WORKDIR /app

# 复制全量依赖和prisma文件
COPY --from=deps /app/node_modules ./node_modules
COPY prisma ./prisma
RUN npx prisma generate

#############
## 构建阶段 ##
#############
FROM node:18-alpine AS builder
RUN apk add --no-cache libc6-compat
RUN corepack enable pnpm

WORKDIR /app

# 复制带Prisma客户端的全量依赖
COPY --from=binaries-deps /app/node_modules ./node_modules
COPY --from=binaries-deps /app/prisma ./prisma

# 复制项目源码
COPY . .

# 执行构建命令（构建阶段无需设置production环境）
RUN pnpm run build:prod

关键修复点说明 #

1. 统一使用pnpm：全程用pnpm管理依赖，避免混用包管理器打乱依赖结构，用corepack enable是更规范的启用方式，无需全局安装pnpm。
2. 安装全量依赖：deps阶段去掉--prod参数，把开发依赖也一并安装，确保构建时需要的TypeScript、类型定义等工具都存在。
3. 延迟设置NODE_ENV：构建阶段不要设置production环境，若需生产环境运行，在最终的运行镜像阶段再设置，避免影响开发依赖的安装。
4. 完整传递依赖：让binaries-deps继承包含全量依赖的deps阶段，再传递给builder，保证构建环境拥有所有必要依赖。

额外提醒 #

• 先检查package.json里的build:prod是否确实仅执行tsc，再确认tsconfig.json的配置（比如outDir、rootDir路径是否匹配项目结构）。
• 构建时可以添加日志输出，比如在构建命令前加RUN cat tsconfig.json，确认配置无误。
• 若想缩小镜像体积，构建完成后可单独创建运行镜像，只复制构建产物和生产依赖，大幅减少镜像体积。

内容的提问来源于stack exchange，提问作者Richard Ryan Garcia