angular-http

@angular/common/http

版本： Angular 21（2025） 标签： HTTP、REST、API、拦截器

参考： HttpClient • API • 拦截器

API 变更

本节记录近期特定版本的 API 变更。

• 新增：函数式拦截器——使用 provideHttpClient(withInterceptors([...])) 设置现代拦截器 来源

• 新增：withFetch——在 HttpClient 中使用原生 fetch API 来源

• 新增：withInterceptorsFromDi——通过函数式方式支持旧版拦截器

• 新增：HttpContext 令牌——使用 HttpContextToken 设置单个请求的元数据

• 新增：支持 AbortSignal——支持超时的请求取消

• 已弃用：基于类的 HttpInterceptor——迁移到函数式拦截器

最佳实践

• 使用函数式拦截器

// ✅ Modern functional interceptor
export const authInterceptor: HttpInterceptorFn = (req, next) => {
  const authService = inject(AuthService);
  const token = authService.getToken();
  
  if (token) {
    const authReq = req.clone({
      setHeaders: { Authorization: `Bearer ${token}` }
    });
    return next(authReq);
  }
  return next(req);
};

// Register
export const appConfig: ApplicationConfig = {
  providers: [
    provideHttpClient(withInterceptors([authInterceptor]))
  ]
};

• 使用拦截器处理横切关注点——身份验证、日志记录、错误处理

// Error interceptor with retry
export const errorInterceptor: HttpInterceptorFn = (req, next) => {
  return next(req).pipe(
    catchError((error: HttpErrorResponse) => {
      if (error.status === 401) {
        inject(Router).navigate(['/login']);
      }
      return throwError(() => error);
    })
  );
};

• 对不稳定网络使用带退避机制的重试

import { retry, delay, catchError } from 'rxjs/operators';

http.get('/api/data').pipe(
  retry({ count: 3, delay: 1000 })
);

• 使用 HttpContext 设置单个请求的标记

const cacheToken = new HttpContextToken<boolean>(() => false);

export const cacheInterceptor: HttpInterceptorFn = (req, next) => {
  if (req.context.get(cacheToken)) {
    // Check cache
  }
  return next(req);
};

// Usage
http.get('/api/data', {
  context: new HttpContext().set(cacheToken, true)
});

• 为 HTTP 响应使用正确的类型

interface User {
  id: number;
  name: string;
}

http.get<User>('/api/user/1').subscribe(user => {
  console.log(user.name); // TypeScript knows the type
});

• 使用 observe: 'response' 获取完整的 HTTP 响应

http.get('/api/data', { observe: 'response' }).subscribe(response => {
  console.log(response.headers);
  console.log(response.body);
});

• 全局处理错误

@Injectable()
export class GlobalErrorHandler implements ErrorHandler {
  handleError(error: Error) {
    // Log to error tracking service
    console.error(error);
  }
}

// Register
provideErrorHandler(GlobalErrorHandler)

• 对 CORS 请求使用 withCredentials

http.get('/api/data', { withCredentials: true });