Karma+Jasmine测试路由时spyOn找不到router监听对象报错

问题表现 #

使用 Karma + Jasmine 做 Angular Router 单元测试时，始终拿不到 Router 实例，spyOn 监听 navigate 方法直接失效，控制台报错：could not find an object to spy upon for navigate()。
已尝试的操作均未生效：

• 调整 Router 在 TestBed 配置里的注入顺序，运行结果无变化
• 尝试把 TestBed 注入的 Router 声明为普通对象类型而非服务类型
• 在代码不同执行节点加日志打印 Router 实例，输出全是 undefined
  相关报错截图：
  
  

排查修复步骤 #

1. 优先检查TestBed模块导入配置 #

注意：单独在providers数组里引入Router服务是无效的，路由依赖没有完整初始化的情况下，Router实例必然是undefined
路由测试必须导入官方提供的路由测试专用模块，参考正确配置：

// 错误写法
beforeEach(() => {
  TestBed.configureTestingModule({
    providers: [Router] // 仅单独引入Router服务无法完成初始化
  })
})

// 正确写法
import { RouterTestingModule } from '@angular/router/testing';
beforeEach(() => {
  TestBed.configureTestingModule({
    imports: [
      // 传入测试用的路由配置表，没有自定义测试路由就传空数组
      RouterTestingModule.withRoutes([])
    ],
    declarations: [被测组件, 其他依赖组件]
  })
})

2. 确认Router实例的获取时机正确 #

必须等TestBed配置完成、组件编译结束后再获取Router实例，提前拿只会拿到undefined：

let router: Router;
let fixture: ComponentFixture<被测组件类名>;
beforeEach(async () => {
  // 等待测试模块编译完成
  await TestBed.configureTestingModule({
    imports: [RouterTestingModule.withRoutes([])],
    declarations: [被测组件类名]
  }).compileComponents();

  fixture = TestBed.createComponent(被测组件类名);
  // 编译完成后再通过TestBed注入获取Router实例
  router = TestBed.inject(Router);
  // 触发路由初始化，避免路由未启动导致的异常
  router.initialNavigation();
});

3. 校验spyOn的写法 #

必须确认router实例存在之后再调用spyOn，不要在实例未定义的阶段执行监听逻辑：

it('触发操作后应该跳转到指定路由', () => {
  // 实例存在后再注册spy
  const navigateSpy = spyOn(router, 'navigate');
  // 触发页面上的跳转逻辑，比如点击跳转按钮
  fixture.nativeElement.querySelector('.跳转按钮类名').click();
  fixture.detectChanges();
  // 校验跳转参数是否符合预期
  expect(navigateSpy).toHaveBeenCalledWith(['/目标路由地址']);
})

4. 其他高频踩坑点 #

• 如果用了waitForAsync/fakeAsync包裹测试逻辑，不要在异步作用域外获取Router实例
• 不要随意重写Router的依赖提供，比如不要写{provide: Router, useValue: {}}这种残缺的mock，要么用RouterTestingModule提供的真实实例，要么自己写全mock对象的所有用到的方法
• 独立组件做测试时，直接在imports数组里加RouterTestingModule即可，不要漏加

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