本文旨在解决 Angular 应用中使用 combineLatest 结合多个 Observable 实现路由守卫时，可能出现的逻辑错误问题。通过分析一个实际案例，我们将深入探讨如何正确地使用 combineLatest，避免不必要的页面跳转，并提供清晰的代码示例和注意事项，帮助开发者构建更健壮的路由守卫。
在使用 Angular 开发应用时，路由守卫（Guards）是控制用户访问特定路由的重要机制。当需要根据多个条件（例如：用户权限、数据状态等）来决定是否允许用户访问某个路由时，常常会用到 RxJS 的 combineLatest 操作符。然而，不当的使用可能导致意料之外的行为，例如不正确的页面重定向。
问题分析
假设我们有一个场景：需要创建一个路由守卫 CanCreateNewCv，用于控制用户是否可以访问 /new 页面。该守卫需要同时检查两个条件：
- 用户是否已经创建了 CV（简历）。
- 用户是否是管理员或经理。
如果用户已经创建了 CV，并且不是管理员或经理，则不允许访问 /new 页面，并重定向到 /list 页面。如果用户是管理员或经理，则允许访问 /new 页面，无论是否已经创建了 CV。
以下是可能存在问题的代码：
import { Injectable } from '@angular/core';
import { CanActivate, Router } from '@angular/router';
import { Observable, combineLatest } from 'rxjs';
import { map, finalize } from 'rxjs/operators';
import { PersonsService } from '../services/persons.service';
import { AdministrationService } from '../services/administration.service';
import { CustomSnackbarService } from '../services/custom-snackbar.service';
@Injectable({
providedIn: 'root',
})
export class CanCreateNewCv implements CanActivate {
constructor(
private usersService: PersonsService,
private router: Router,
private administrationService: AdministrationService,
private snackbarService: CustomSnackbarService
) {}
canActivate(): Observable<boolean> | boolean | Promise<boolean> {
let isAllowed = false;
const cv$ = this.usersService.getPersonsByPageAndFilter(10, 0).pipe(
map((data) => {
if (data.allDataCount > 0) {
this.router.navigateByUrl('/list');
return true;
}
return false;
})
);
const admin$ = this.administrationService.getCurrentUser().pipe(
map((currentUser) => {
if (currentUser.isAdmin || currentUser.isManager) {
return true;
}
return false;
})
);
return combineLatest([cv$, admin$], (isCvUploaded, isAdminOrManager) => {
isAllowed = isAdminOrManager ? true : isCvUploaded ? false : true;
return isAllowed;
}).pipe(
finalize(() => {
if (!isAllowed)
this.snackbarService.open(
'This profile has CV already created!',
'Info'
);
})
);
}
}上述代码的问题在于，无论用户是否是管理员或经理，cv$ Observable 都会尝试重定向到 /list 页面。这导致即使管理员或经理访问 /new 页面，也会被重定向。
解决方案
要解决这个问题，需要将页面重定向的逻辑移到 combineLatest 的回调函数中，只有当 isAllowed 为 false 时才进行重定向。同时，简化 cv$ 和 admin$ Observable 的 map 操作，直接返回布尔值。
以下是修改后的代码：
import { Injectable } from '@angular/core';
import { CanActivate, Router } from '@angular/router';
import { Observable, combineLatest } from 'rxjs';
import { map, finalize } from 'rxjs/operators';
import { PersonsService } from '../services/persons.service';
import { AdministrationService } from '../services/administration.service';
import { CustomSnackbarService } from '../services/custom-snackbar.service';
@Injectable({
providedIn: 'root',
})
export class CanCreateNewCv implements CanActivate {
constructor(
private usersService: PersonsService,
private router: Router,
private administrationService: AdministrationService,
private snackbarService: CustomSnackbarService
) {}
canActivate(): Observable<boolean> | boolean | Promise<boolean> {
let isAllowed = false;
const cv$ = this.usersService
.getPersonsByPageAndFilter(10, 0)
.pipe(map((data) => data.allDataCount > 0));
const admin$ = this.administrationService
.getCurrentUser()
.pipe(map((currentUser) => currentUser.isAdmin || currentUser.isManager));
return combineLatest([cv$, admin$], (isCvUploaded, isAdminOrManager) => {
isAllowed = isAdminOrManager ? true : isCvUploaded ? false : true;
if (!isAllowed) {
this.router.navigateByUrl('/list');
}
return isAllowed;
}).pipe(
finalize(() => {
if (!isAllowed)
this.snackbarService.open(
'This profile has CV already created!',
'Info'
);
})
);
}
}在这个修改后的版本中，cv$ Observable 现在直接返回一个布尔值，指示用户是否已经上传了 CV。admin$ Observable 也做了类似的简化，直接返回一个布尔值，指示用户是否是管理员或经理。
关键的改变在于 combineLatest 的回调函数中，只有当 isAllowed 为 false 时，才会调用 this.router.navigateByUrl('/list') 进行页面重定向。这样确保了只有当用户不是管理员或经理，并且已经上传了 CV 时，才会被重定向到 /list 页面。
注意事项
- 避免在 Observable 中进行副作用操作： 尽量避免在 Observable 的 map 操作符中直接进行页面重定向等副作用操作。将这些操作移到 combineLatest 的回调函数中，可以更好地控制执行时机。
- 理解 combineLatest 的行为： combineLatest 会在所有输入 Observable 都发出至少一个值后，才会发出值。因此，确保所有输入 Observable 都会发出值，否则守卫可能无法正常工作。
- 错误处理： 在实际应用中，需要考虑错误处理的情况。如果 getPersonsByPageAndFilter 或 getCurrentUser 方法抛出错误，可能会导致守卫无法正常工作。可以使用 RxJS 的 catchError 操作符来处理这些错误。
总结
通过本文的分析，我们了解了如何正确地使用 combineLatest 结合多个 Observable 实现 Angular 路由守卫。关键在于理解 combineLatest 的行为，并避免在 Observable 中进行不必要的副作用操作。通过合理地组织代码，可以构建出更健壮、更可靠的路由守卫。
