Angular集成@microsoft/signalr ^8.0.0时遇TS7030编译报错

问题根源 #

该错误来自node_modules内的SignalR源码，修改项目的noImplicitReturns配置无效，是因为Angular编译器默认会对依赖包的类型进行检查，尤其是开启严格模式相关配置时，会扫描到依赖库中的代码缺陷。

解决方案 #

方案1：跳过库文件类型检查（推荐） #

在项目根目录的tsconfig.json中，开启skipLibCheck配置，让TypeScript跳过对第三方库的类型检查：

{
  "compilerOptions": {
    "skipLibCheck": true,
    // 保留你原有其他配置
  }
}

方案2：排除SignalR源码的检查范围 #

如果不想全局跳过库检查，可以单独把SignalR的源码目录加入exclude列表：

{
  "exclude": [
    "node_modules/@microsoft/signalr/src/**/*",
    "src/test.ts",
    "src/**/*.spec.ts"
  ]
}

方案3：调整SignalR版本 #

尝试升级@microsoft/signalr到最新版本（官方可能已修复该类型问题），或降级到7.x版本规避冲突：

# 升级到最新版
npm install @microsoft/signalr@latest

# 降级到7.x稳定版
npm install @microsoft/signalr@^7.0.0

方案4：核对Angular版本兼容性 #

@microsoft/signalr 8.x版本通常适配Angular 16及以上版本，若你的Angular版本过低，可能出现编译冲突，建议升级Angular到对应兼容版本。

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