NodeJS Docker部署遇ENOENT错误：文件路径问题排查

问题根源 #

你遇到的核心问题是宿主机文件路径和容器内路径不匹配，加上对Docker构建时文件复制逻辑的理解偏差：

• 你手动把文件放到宿主机的container1目录，但这个目录大概率不是Docker构建上下文，或者Dockerfile/代码里的路径配置错误，导致容器内/app/usr/src/app/路径下没有目标文件。
• 报错路径/app/usr/src/app/存在重复嵌套问题（多了一层/app/前缀），这通常是Dockerfile里的路径配置错误导致的。

解决步骤 #

1. 理清Docker构建的文件复制逻辑

Docker构建时，COPY/ADD指令是从构建上下文（执行docker build命令的当前目录）复制文件到容器内的指定路径，和你手动放到宿主机某个目录的文件无关。比如：

• 如果你的Dockerfile写了COPY checksum.txt /usr/src/app/，那构建上下文（docker build所在目录）里必须有checksum.txt，容器内/usr/src/app/下才会出现这个文件。

2. 修正Dockerfile的路径配置

检查你的Dockerfile，避免路径重复嵌套：

• 如果你设置了WORKDIR /usr/src/app，那复制文件时直接用相对路径即可：

  WORKDIR /usr/src/app
  # 把构建上下文里的checksum.txt复制到当前工作目录（/usr/src/app）
  COPY checksum.txt .
  

• 不要写成COPY checksum.txt /app/usr/src/app/，这会导致容器内出现冗余的/app/前缀路径，和代码里的路径预期不匹配。

3. 修正NodeJS代码的文件路径

代码里读取文件时，避免硬编码绝对路径，用动态路径适配容器环境：

const fs = require('fs');
const path = require('path');

// 基于当前脚本所在目录(__dirname)构建文件路径
const checksumFilePath = path.join(__dirname, 'checksum.txt');
// 或者基于当前工作目录(process.cwd())构建
// const checksumFilePath = path.join(process.cwd(), 'checksum.txt');

try {
  const checksum = fs.readFileSync(checksumFilePath, 'utf8');
  // 处理校验和逻辑
} catch (err) {
  console.error('读取校验和文件失败:', err.message);
}

4. 验证容器内的文件状态

构建临时镜像并进入容器，确认文件是否在正确路径：

# 构建镜像
docker build -t temp-node-app .
# 进入容器交互终端
docker run -it temp-node-app sh
# 检查文件是否存在
ls -l /usr/src/app/
# 若报错路径是/app/usr/src/app/，也检查这个路径
ls -l /app/usr/src/app/

如果该路径不存在或无文件，说明Dockerfile的COPY指令或构建上下文有问题。

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