Angular项目编译失败求助：Node核心模块缺失及配置无效

API 探路者

2026-7-5

Angular编译失败：无法解析Node.js核心模块的解决方案

核心问题

你的Angular前端项目中意外引入了express这类Node.js后端框架，浏览器环境不支持fs、http、async_hooks等Node核心模块，这才是编译失败的根本原因，单纯配置webpack fallback无法解决。

排查与修复步骤

1. 移除不必要的后端依赖

检查代码中是否有import express或类似后端模块的引入语句，直接删除
执行命令卸载express（如果是误安装）：
```
npm uninstall express
```
查看package.json的dependencies/devDependencies，删除所有前端不需要的后端依赖

2. 补充webpack配置

在你的webpack.config.js中，添加缺失的async_hooks fallback，并增加externals排除后端模块：

const webpack = require('webpack');

module.exports = {
  resolve: {
    fallback: {
      assert: require.resolve('assert/'),
      fs: false,
      http: require.resolve('stream-http'),
      net: require.resolve('net'),
      crypto: require.resolve('crypto-browserify'),
      path: require.resolve('path-browserify'),
      stream: require.resolve('stream-browserify'),
      zlib: require.resolve('browserify-zlib'),
      querystring: require.resolve('querystring-es3'),
      util: require.resolve('util/'),
      async_hooks: false // 新增：排除浏览器不支持的async_hooks
    },
  },
  externals: { // 新增：排除后端模块，不让webpack编译它们
    express: 'commonjs express',
    fs: 'commonjs fs',
    http: 'commonjs http'
  },
  plugins: [
    new webpack.ProvidePlugin({
      process: 'process/browser',
      Buffer: ['buffer', 'Buffer'],
    }),
  ],
};

3. 清理缓存并重启服务

npm cache clean --force
# Windows系统执行下面两行
rd /s /q node_modules
del package-lock.json
# Mac/Linux系统执行下面两行
rm -rf node_modules package-lock.json

npm install
ng serve --open