Podman执行RUN npm install时出现“directory not empty”错误的原因

问题根源 #

你在Dockerfile里设置的WORKDIR路径包含空格和转义字符，容器内的目录结构和主机完全独立，主机的/home/dcaron/React-Admin\ Podman\ Test/client路径在容器中不仅不存在，带空格的路径还会导致Buildah（Podman底层构建工具）在挂载文件系统时出现目录非空的错误。

修复步骤 #

• 简化容器内工作目录：使用无空格的简洁路径（如/app），避免转义字符和特殊字符带来的挂载问题。
• 调整Dockerfile指令顺序：先复制依赖配置文件，再执行npm install，后续再复制源码，这样能利用Docker缓存提升构建效率。

修改后的Dockerfile #

# 构建React应用
FROM node:lts-alpine

# 设置容器内的工作目录（无空格，简洁路径）
WORKDIR /app

# 先复制依赖配置文件，利用缓存
COPY package.json package-lock.json ./
RUN npm install

# 再复制应用源码
COPY public ./public
COPY src ./src

# 开发环境启动命令
CMD ["npm", "run", "dev"]

额外注意事项 #

• 执行构建命令时，确保在主机的React项目根目录（即包含package.json的目录）下运行：

  podman build -t react-test .
  

• WSL环境下，尽量避免用sudo运行Podman（除非必要），普通用户权限即可完成大部分操作。

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