Angular报错：ModuleWithProviders<T>需1个类型参数的求助

问题详情 #

报错信息：Generic type 'ModuleWithProviders<T>' requires 1 type argument(s)
错误位置：node_modules@nguniversal\module-map-ngfactory-loader\src\module-map-loader.module.d.ts 文件最后一行的 ModuleWithProviders 被红线标注。

涉及代码片段：

/**
 * @license
 * Copyright Google LLC All Rights Reserved.
 *
 * Use of this source code is governed by an MIT-style license that can be
 * found in the LICENSE file at https://angular.io/license
 */
import { ModuleWithProviders, StaticProvider } from '@angular/core';
import { ModuleMap } from './module-map';
/**
 * Helper function for getting the providers object for the MODULE_MAP
 *
 * @param moduleMap Map to use as a value for MODULE_MAP
 */
export declare function provideModuleMap(moduleMap: ModuleMap): StaticProvider;
/**
 * Module for using a NgModuleFactoryLoader which does not lazy load
 */
export declare class ModuleMapLoaderModule {
    /**
     * Returns a ModuleMapLoaderModule along with a MODULE_MAP
     *
     * @param moduleMap Map to use as a value for MODULE_MAP
     */
    static withMap(moduleMap: ModuleMap): ModuleWithProviders;
}

已知尝试：已在tsconfig中添加skipLibCheck: true但无效；全局Angular版本14.2.8，本地项目版本12.2.2。

复现步骤：

• 在Visual Studio中创建新的ASP.NET Web API with Angular项目
• 创建包含component.ts和component.html的组件文件夹
• 构建并运行解决方案

问题原因 #

Angular 10及以后版本中，ModuleWithProviders 类型要求必须显式传入泛型类型参数，但你使用的@nguniversal/module-map-ngfactory-loader包的类型定义文件里，withMap方法返回的ModuleWithProviders未添加泛型参数，触发类型检查失败。

另外，全局Angular版本（14）与本地项目版本（12）不一致，可能引发依赖解析冲突；skipLibCheck未生效大概率是因为配置未放在正确位置，或者项目存在多个tsconfig文件（如tsconfig.app.json），未确保配置覆盖所有相关文件。

解决方案 #

方案1：升级/替换兼容的依赖包 #

@nguniversal/module-map-ngfactory-loader 在Angular 12+版本中已被官方弃用，建议替换为Angular Router原生懒加载方式，或安装适配Angular 12的版本：

1. 卸载现有包：

npm uninstall @nguniversal/module-map-ngfactory-loader

2. 改用Angular Router标准懒加载，示例：

// 路由配置中使用
{
  path: 'lazy',
  loadChildren: () => import('./lazy/lazy.module').then(m => m.LazyModule)
}

若仍需使用模块映射加载器，安装适配Angular 12的版本：

npm install @nguniversal/module-map-ngfactory-loader@12.1.0 --save-dev

方案2：修正tsconfig配置确保skipLibCheck生效 #

确保skipLibCheck配置在tsconfig.json的compilerOptions中，同时检查项目的tsconfig.app.json是否继承根配置，或直接在tsconfig.app.json中添加：

{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

保存后重启IDE，让配置生效。

方案3：临时修改类型文件（不推荐） #

若上述方案无法快速生效，可临时修改node_modules中的类型文件：
将module-map-loader.module.d.ts最后一行的：

static withMap(moduleMap: ModuleMap): ModuleWithProviders;

修改为：

static withMap(moduleMap: ModuleMap): ModuleWithProviders<ModuleMapLoaderModule>;

注意：此修改会在npm install后被覆盖，仅作为临时应急方案。

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