Docker镜像构建时无法定位Secrets目录的问题求助

核心原因 #

Docker BuildKit的--mount=type=secret默认将秘钥挂载到**/run/secrets/<secret-id>**路径下，而非你项目目录内的/app/run/secrets/。你的构建脚本试图读取项目内的路径，导致文件找不到。

分步修复 #

1. 调整Dockerfile的秘钥读取逻辑 #

修改Build阶段的挂载与环境变量导出代码，直接使用Docker默认的秘钥挂载路径：

FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci

# 挂载秘钥并导出为环境变量，注意路径是/run/secrets/而非/app/run/secrets/
RUN --mount=type=secret,id=EMAIL_SERVER_HOST \
    --mount=type=secret,id=EMAIL_SERVER_PORT \
    export EMAIL_SERVER_HOST=$(cat /run/secrets/EMAIL_SERVER_HOST) && \
    export EMAIL_SERVER_PORT=$(cat /run/secrets/EMAIL_SERVER_PORT) && \
    npm run build

# 运行阶段镜像（保留你的原有配置即可）
FROM node:18-alpine AS runner
WORKDIR /app
COPY --from=builder /app/.next ./.next
COPY --from=builder /app/public ./public
COPY --from=builder /app/package*.json ./
RUN npm ci --only=production
EXPOSE 3000
CMD ["npm", "start"]

2. 修正docker-compose.yml的秘钥配置 #

确保Compose正确关联主机秘钥文件与Build阶段的秘钥ID：

version: '3.8'
services:
  next-app:
    build:
      context: .
      # 声明Build阶段需要用到的秘钥
      secrets:
        - EMAIL_SERVER_HOST
        - EMAIL_SERVER_PORT
    ports:
      - "3000:3000"

# 定义秘钥来源，指向你主机项目根目录的run/secrets文件
secrets:
  EMAIL_SERVER_HOST:
    file: ./run/secrets/EMAIL_SERVER_HOST
  EMAIL_SERVER_PORT:
    file: ./run/secrets/EMAIL_SERVER_PORT

3. 确认Next.js的环境变量读取逻辑 #

确保Next.js在构建时直接读取环境变量，而非尝试读取文件路径：

// next.config.js
module.exports = {
  env: {
    EMAIL_SERVER_HOST: process.env.EMAIL_SERVER_HOST,
    EMAIL_SERVER_PORT: process.env.EMAIL_SERVER_PORT,
  },
  // 若使用Next.js 13+ App Router，可保留原有env配置逻辑
};

关键注意点 #

• BuildKit的秘钥挂载是临时的，构建完成后会自动清理，不会将秘钥文件打包到最终镜像中，安全性有保障。
• 每个秘钥的ID必须在Dockerfile的--mount=type=secret,id=<xxx>和compose.yml的secrets段中保持一致。
• 若你的Next.js应用依赖.env文件，无需在构建阶段复制该文件，直接通过挂载秘钥导出环境变量即可满足构建需求。

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