angular.js如何优雅调接口？跨域、缓存、错误处理怎么做？

在 Angular.js 开发中，调用接口（API）是与后端服务进行数据交互的核心环节，本文将系统介绍 Angular.js 中接口调用的核心方法、最佳实践及常见问题解决方案,帮助开发者高效实现前后端数据通信。

接口调用的核心：$http 服务

Angular.js 内置的 $http 服务是进行 HTTP 请求的主要工具，它基于浏览器 XMLHttpRequest 对象或 JSONP 实现，支持 GET、POST、PUT、DELETE 等多种请求方法，使用 $http 时，需先将其注入到控制器或服务中,再调用相应方法发起请求。

基本请求格式

$http 的核心方法为 config 对象，包含 method（请求方法）、url（接口地址）、params（GET 请求参数）、data（POST/PUT 请求体）等属性。

$http({
  method: 'GET',
  url: '/api/users',
  params: { page: 1, limit: 10 }
}).then(function(response) {
  // 请求成功处理
  console.log(response.data);
}, function(error) {
  // 请求失败处理
  console.error(error);
});

快捷方法

为简化开发，$http 提供了 GET、POST、PUT、DELETE 等快捷方法，直接传递 URL 和参数即可：

// GET 请求快捷方式
$http.get('/api/users', { params: { page: 1 } })
  .then(successCallback, errorCallback);
// POST 请求快捷方式
$http.post('/api/users', { name: 'John', age: 25 })
  .then(successCallback, errorCallback);

请求配置与参数传递

请求参数区分

• GET 请求参数：通过 params 属性传递，$http 会自动将其拼接为 URL 查询字符串（如 ?page=1&limit=10）。
• POST/PUT 请求参数：通过 data 属性传递，默认以 JSON 格式发送至请求体，后端需通过 Content-Type: application/json 解析。

请求头配置

可通过 headers 属性自定义请求头，例如设置 Content-Type 或 Authorization：

$http({
  method: 'POST',
  url: '/api/login',
  data: { username: 'admin', password: '123456' },
  headers: { 'Content-Type': 'application/json' }
});

跨域请求处理

当前端与后端服务跨域时，需确保后端配置了 CORS（跨域资源共享）策略，Angular.js 默认支持跨域，无需额外配置，但后端需返回包含 Access-Control-Allow-Origin 的响应头。

响应数据处理与拦截

响应结构解析

$http 请求返回的 response 对象包含以下核心属性：

• data：后端返回的数据主体（已通过 JSON.parse 解析）。
• status：HTTP 状态码（如 200、404、500）。
• headers：响应头信息。
• config：请求时的配置对象。

开发者通常只需关注 response.data 即可获取业务数据。

响应拦截器

通过 $httpProvider 的拦截器（Interceptor），可统一处理请求/响应逻辑，例如添加全局 token、统一错误处理等，拦截器需实现 request、requestError、response、responseError 四个方法：

app.config(function($httpProvider) {
  $httpProvider.interceptors.push('authInterceptor');
});
app.factory('authInterceptor', function($q, $localStorage) {
  return {
    request: function(config) {
      // 统一添加 token
      if ($localStorage.token) {
        config.headers.Authorization = 'Bearer ' + $localStorage.token;
      }
      return config;
    },
    responseError: function(rejection) {
      // 统一处理 401 错误
      if (rejection.status === 401) {
        $location.path('/login');
      }
      return $q.reject(rejection);
    }
  };
});

常见问题与解决方案

缓存问题

GET 请求默认会被浏览器缓存，可能导致数据未及时更新，可通过 cache: false 禁用缓存,或添加时间戳参数强制刷新：

$http.get('/api/data', { cache: false });
// 或
$http.get('/api/data', { params: { _: new Date().getTime() } });

JSONP 请求

对于不支持 CORS 的旧接口，可通过 JSONP 方式调用，需在 $http 配置中设置 jsonpCallback，并确保后端支持 JSONP 格式：

$http.jsonp('https://api.example.com/data?callback=JSON_CALLBACK');

请求超时处理

通过 timeout 属性设置超时时间（单位毫秒），超时后触发 responseError 回调：

var timeoutPromise = $timeout(function() {}, 5000);
$http.get('/api/slow-data', { timeout: timeoutPromise })
  .then(function(response) {
    $timeout.cancel(timeoutPromise);
  });

最佳实践总结

1. 统一封装接口服务：将接口调用逻辑封装在服务（Service）中，而非控制器中，实现数据复用与逻辑解耦。
2. 错误处理优先：为所有接口添加错误处理回调，避免因网络异常或后端错误导致页面崩溃。
3. 避免内存泄漏：在控制器销毁时取消未完成的 $http 请求，通过 $http.pendingRequests 检查并取消。
4. 遵循 RESTful 规范：合理使用 GET、POST、PUT、DELETE 等方法，确保接口设计与前端调用逻辑一致。

通过掌握 Angular.js 接口调用的核心方法与最佳实践，开发者可构建出高效、稳定的前后端交互应用，在实际开发中，需结合项目需求灵活运用 $http 服务,并通过拦截器等工具提升代码的可维护性。