NestJS文件变更后重载速度极慢，如何优化？

你的问题核心在于当前配置导致文件变更时触发全量编译和服务器重启，而非仅热重载变更模块。以下是具体优化步骤：

1. 修正Docker卷挂载配置 #

当前docker-compose.yml中把../src直接挂载到/home/node/app会覆盖容器内的项目根目录，导致node_modules等依赖丢失或冲突，迫使每次变更都重新安装依赖/编译所有文件。

修改app服务的volumes配置：

volumes:
  - ../:/home/node/app  # 挂载整个项目目录到容器
  - /home/node/app/node_modules  # 保留容器内的node_modules，避免宿主依赖干扰

或者更精准地仅挂载需要热更的文件：

volumes:
  - ../src:/home/node/app/src
  - ../package.json:/home/node/app/package.json
  - ../tsconfig.json:/home/node/app/tsconfig.json
  - ../webpack-hmr.config.js:/home/node/app/webpack-hmr.config.js

2. 调整开发启动脚本 #

当前脚本同时使用--webpack和--tsc会导致冲突，--tsc会强制使用TypeScript编译器而非Webpack，失去HMR的优势。

修改package.json中的start:dev：

"start:dev": "nest start --webpack --webpackPath webpack-hmr.config.js --watch"

3. 配置Webpack HMR实现模块热替换 #

确保你的webpack-hmr.config.js正确启用HMR，避免全量重启。示例配置：

const nodeExternals = require('webpack-node-externals');
const { RunScriptWebpackPlugin } = require('run-script-webpack-plugin');

module.exports = function (options, webpack) {
  return {
    ...options,
    entry: ['webpack/hot/poll?100', options.entry],
    externals: [
      nodeExternals({
        allowlist: ['webpack/hot/poll?100'],
      }),
    ],
    plugins: [
      ...options.plugins,
      new webpack.HotModuleReplacementPlugin(),
      new webpack.WatchIgnorePlugin({
        paths: [/\.js$/, /\.d\.ts$/],
      }),
      new RunScriptWebpackPlugin({ name: options.output.filename, autoRestart: false }),
    ],
  };
};

注意：需要安装依赖webpack-node-externals和run-script-webpack-plugin：

npm install --save-dev webpack-node-externals run-script-webpack-plugin

4. 优化TypeScript增量编译和文件监听 #

你的tsconfig.json已经开启incremental: true，但还可以调整监听策略以适配Docker文件系统：

• 将watchOptions中的watchFile改为useFsEvents（如果Docker支持文件系统事件）：

"watchOptions": {
  "watchFile": "useFsEvents",
  "watchDirectory": "useFsEvents",
  "fallbackPolling": "dynamicPriority",
  "excludeDirectories": ["**/node_modules", "dist", "test"]
}

如果是Docker Desktop for Mac/Windows，确保已启用"使用gRPC FUSE进行文件共享"（在设置>资源>文件共享中），提升文件事件传递效率。

5. 验证Dockerfile配置 #

确保你的Dockerfile正确安装依赖，避免每次启动都重新安装：

FROM node:18-alpine

WORKDIR /home/node/app

# 先复制package文件，利用Docker缓存
COPY package*.json ./
RUN npm install

# 再复制项目源码
COPY . .

USER node

完成以上配置后，文件变更时应该只会编译修改的模块，通过HMR更新而不重启整个服务器，大幅缩短热重载时间。

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