NestJS在Linux（Docker容器）环境下资源文件复制功能失效问题求助

看起来你遇到的问题很典型——本地开发正常，但Docker构建后资源文件丢失，而且没有明显报错。结合你的配置和环境差异，我整理了几个针对性的排查和解决方向：

1. 检查路径大小写一致性 #

MacOS的默认文件系统不区分大小写，但Linux（Docker镜像用的Alpine）严格区分大小写。如果你的资源文件实际扩展名或路径和nest-cli.json里的配置不匹配（比如配置写的**/*.jpg，但文件是*.JPG），本地构建能正常匹配，但Docker里就会找不到文件。

• 逐一核对所有资源文件的路径、文件名和扩展名，确保和nest-cli.json中的assets规则完全一致。

2. 验证Docker镜像中的源文件是否完整 #

有时候问题出在Docker的COPY步骤，某些资源文件可能被.dockerignore排除，或者没有被正确复制到镜像中：

• 临时运行镜像进入容器，检查源文件是否存在：

  docker run -it --rm <你的镜像ID> sh
  cd /var/www/backend/src
  # 查看对应module/services目录下的资源文件是否存在
  ls modules/your-module/templates/
  

• 如果文件不存在，检查项目根目录的.dockerignore文件，确保没有排除.hbs、.css、图片等资源文件；同时确认COPY backend /var/www/backend命令覆盖了所有包含资源文件的子目录。

3. 强制指定Nest CLI配置文件构建 #

在Docker环境下，Nest CLI偶尔会因为工作目录或环境变量问题，无法自动加载nest-cli.json。可以在构建命令中明确指定配置文件，确保资产复制规则被正确应用：
修改Dockerfile中的构建步骤：

RUN cd ./backend && npm i --legacy-peer-deps && npx nest build --config nest-cli.json

4. 禁用watchAssets并检查构建日志 #

watchAssets是开发模式下的特性，生产构建时开启可能会导致异常。先修改nest-cli.json：

{
  "compilerOptions": {
    "assets": [ "**/*.hbs", "**/*.css", "**/*.jpg", "**/*.png", "**/*.jpeg" ],
    "watchAssets": false
  }
}

然后在Dockerfile中开启构建详细日志，查看Nest CLI是否在处理资产：

RUN cd ./backend && npm i --legacy-peer-deps && npm run build --verbose

如果日志中没有出现类似Copying assets...的输出，说明Nest CLI没有识别到资产配置；如果有输出但dist目录下没有文件，可能是权限或路径解析问题。

5. 更换基础镜像尝试兼容性问题 #

mhart/alpine-node镜像虽然轻量，但可能和某些Nest CLI依赖存在兼容性问题。试试官方Node Alpine镜像：

FROM node:18-alpine
RUN npm install pm2 -g
COPY backend /var/www/backend
COPY process.json /var/www
WORKDIR /var/www
RUN cd ./backend && npm i --legacy-peer-deps && npx nest build --config nest-cli.json
EXPOSE 80
CMD ["pm2-runtime", "./backend/main"]

6. 检查文件权限 #

虽然你没有报错，但Docker镜像中文件权限可能导致Nest CLI无法读取源资源文件。可以在构建后添加权限设置：

RUN cd ./backend && npm i --legacy-peer-deps && npx nest build --config nest-cli.json
# 添加权限设置，确保node用户能访问文件
RUN chown -R node:node /var/www/backend
USER node

按照这个顺序排查，应该能定位到问题所在。我之前遇到过类似的大小写匹配问题，切换到严格大小写检查后就解决了。

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