Angular在Docker开发环境配置失败，请求排查指引

核心问题分析 #

报错failed to compute cache key: "/package.json" not found的直接原因是：
你的Docker构建上下文是项目根目录（docker-compose.yaml里context: .），但Dockerfile里的COPY package.json .是从上下文根目录寻找该文件，而实际package.json存放在portal/子目录下，导致构建时找不到目标文件。

具体修复步骤 #

1. 修正Dockerfile中的文件路径 #

修改builder阶段的COPY命令，指定正确的文件位置：

###### Install dependencies only when needed ######
FROM node:16-alpine AS builder

ARG CONFIGURATION='development'

WORKDIR /app

# 修正：从构建上下文的portal目录复制依赖配置文件
COPY portal/package.json .
COPY portal/package-lock.json . # 建议同时复制lock文件，保证依赖版本一致

RUN npm install --legacy-peer-deps

# 复制portal目录下的所有源码文件
COPY portal/ .

RUN npm run build -- --output-path=dist --configuration=$CONFIGURATION --output-hashing=all


######  Use NgInx alpine image  ###### 
FROM nginx:stable-alpine

RUN rm -rf /usr/share/nginx/html/*

# 上下文为根目录，该路径无需修改
COPY sys/portal/default.conf /etc/nginx/nginx.conf

COPY --from=builder /app/dist /usr/share/nginx/html

CMD ["nginx", "-g", "daemon off;"]

2. 可选：调整docker-compose的构建上下文（简化路径） #

如果希望Dockerfile里的路径更简洁，可以把构建上下文改为portal/目录，但需同步调整nginx配置文件的COPY路径（因为上下文变更，需要从上级目录引用）：
修改docker-compose.yaml的build部分：

build:
  context: ./portal
  dockerfile: ../sys/portal/Dockerfile

同时修改Dockerfile里的nginx配置COPY命令：

COPY ../sys/portal/default.conf /etc/nginx/nginx.conf

这种方式下，Dockerfile里可以直接用COPY package.json .，无需加portal/前缀，但要注意跨目录文件引用的正确性。

3. 区分构建与运行时逻辑 #

你的docker-compose.yaml里配置了volumes: - ./portal:/app，这是运行时挂载逻辑，和构建阶段无关。如果是为了开发时热重载可以保留，但不要混淆构建镜像和容器运行的配置逻辑。

4. 验证构建与启动 #

执行构建命令：

docker-compose build portal

构建成功后启动服务：

docker-compose up -d portal

额外优化建议 #

• 在portal/目录下添加.dockerignore文件，排除无需复制到构建上下文的文件，减少构建时间和上下文体积：

node_modules/
dist/
.git/
*.log

• 保留当前Dockerfile的缓存优化逻辑：先复制依赖配置文件，再执行npm install，这样只有当依赖变更时才会重新安装，提升构建效率。

内容的提问来源于stack exchange，提问作者scruffycoder86