迁移ASP.Net Core Angular至SPA模板2.0.0后aspnet-webpack模块缺失报错

我刚帮团队处理过类似的ASP.NET Core Angular迁移问题，来给你一步步梳理清楚：

1. aspnet-webpack 在新版模板中的状态 #

没错，aspnet-webpack 在 Microsoft.DotNet.Web.Spa.ProjectTemplates 2.0.0 模板里已经被完全替代了。新版模板放弃了这个封装层，直接使用原生的 webpack-dev-middleware 和 webpack-hot-middleware 做集成，同时配合 Angular CLI 来管理前端构建流程。

2. 你的项目为什么还在寻找它？ #

这几乎肯定是迁移时遗留的旧配置没清理干净：

• 检查 Startup.cs：是否还保留着旧版的 UseWebpackDevMiddleware 扩展方法调用（这个方法正是 aspnet-webpack 提供的）
• 查看前端配置：package.json 的脚本、webpack.config.js 或 webpack.dev.config.js 里，是否还有引用 aspnet-webpack 的代码
• 另外，有些旧版的第三方工具或自定义构建脚本可能也会间接依赖它

3. 亲测有效的解决步骤 #

第一步：清理旧依赖 #

在项目根目录的终端里执行，卸载不再需要的包：

npm uninstall aspnet-webpack --save-dev

第二步：更新后端Startup配置 #

把旧的Webpack中间件代码替换成新版的SPA服务配置（确保已经安装了 Microsoft.AspNetCore.SpaServices.Extensions NuGet包）：

// 移除旧的Webpack中间件代码：
// app.UseWebpackDevMiddleware(new WebpackDevMiddlewareOptions {
//     HotModuleReplacement = true
// });

// 替换成新版的SPA服务配置：
app.UseSpa(spa =>
{
    spa.Options.SourcePath = "ClientApp";

    if (env.IsDevelopment())
    {
        // 让ASP.NET Core调用Angular CLI的start命令启动开发服务器
        spa.UseAngularCliServer(npmScript: "start");
    }
});

第三步：同步前端配置与依赖 #

• 检查 package.json 的 scripts 部分，确保 start 脚本是 "ng serve"（新版模板的标准配置），而不是旧的webpack启动命令
• 打开所有webpack配置文件，移除所有和 aspnet-webpack 相关的导入、插件配置

第四步：彻底清理并重装依赖 #

有时候缓存会导致依赖残留，执行以下命令重置：

# 删除node_modules和锁文件
rm -rf node_modules
rm package-lock.json
# 重新安装依赖
npm install

如果做完这些还是报错，可以用 npm ls aspnet-webpack 命令查看项目的依赖树，看看是不是某个第三方库间接引入了它，找到后针对性处理即可。

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