Axios 请求库

npm install axios

// ES Module
import axios from 'axios'

// CommonJS
const axios = require('axios')

axios({
  method: 'post',       // 请求方法
  url: '/api/users',    // 请求地址
  baseURL: 'https://api.example.com', // 基础 URL
  headers: {            // 请求头
    'Content-Type': 'application/json',
    'Authorization': 'Bearer token123'
  },
  params: {             // URL 查询参数 (?page=1&size=10)
    page: 1,
    size: 10
  },
  data: {               // 请求体数据
    name: '张三',
    age: 25
  },
  timeout: 5000,        // 超时时间（ms）
  withCredentials: true, // 跨域请求是否携带 Cookie
  responseType: 'json',  // 响应数据类型
})

const requestInterceptor = axios.interceptors.request.use(
  (config) => {
    // 添加认证 token
    const token = localStorage.getItem('token')
    if (token) {
      config.headers.Authorization = `Bearer ${token}`
    }

    // ✅ 显示全局加载状态
    NProgress.start()

    return config  // 必须返回 config
  },
  (error) => Promise.reject(error)
)

// 移除拦截器
axios.interceptors.request.eject(requestInterceptor)

axios.interceptors.response.use(
  (response) => {
    NProgress.done()
    // 直接返回业务数据，省去 .then(res => res.data)
    return response.data
  },
  (error) => {
    NProgress.done()

    if (error.response) {
      switch (error.response.status) {
        case 401:

  // ... 中间省略 ...

      Message.error('请求配置错误')
    }

    return Promise.reject(error)
  }
)

// 针对不同 API 服务使用不同配置
const apiClient = axios.create({
  baseURL: 'https://api.example.com',
  timeout: 10000,
  headers: { 'Content-Type': 'application/json' }
})

// ✅ 多服务场景
const userService = axios.create({ baseURL: 'https://user-api.example.com' })
const orderService = axios.create({ baseURL: 'https://order-api.example.com' })

// 优先级：请求配置 > 实例配置 > 全局默认配置

// 1. 全局默认配置（最低）
axios.defaults.baseURL = 'https://api.example.com'

// 2. 实例配置（中等）
const instance = axios.create({ baseURL: 'https://other-api.example.com' })

// 3. 请求配置（最高）
instance.get('/users', { timeout: 3000 })  // 覆盖实例的 timeout

const controller = new AbortController()

axios.get('/api/users', { signal: controller.signal })

// 取消请求
controller.abort()

function UserList() {
  const [users, setUsers] = useState([])

  useEffect(() => {
    const controller = new AbortController()

    axios.get('/api/users', { signal: controller.signal })
      .then(data => setUsers(data))
      .catch(err => {
        if (axios.isCancel(err)) {
          console.log('请求已取消')  // ✅ 组件卸载时正常取消
        }
      })

    // ✅ 清理函数：组件卸载时取消未完成请求
    return () => controller.abort()
  }, [])

  return <ul>{users.map(u => <li key={u.id}>{u.name}</li>)}</ul>
}

class HttpClient {
  constructor(config) {
    this.instance = axios.create(config)
    this._setupInterceptors()
  }

  _setupInterceptors() {
    this.instance.interceptors.response.use(
      (response) => response.data,
      (error) => {
        if (!axios.isCancel(error)) {
          this._handleError(error)

  // ... 中间省略 ...

  get(url, params, config) { return this.instance.get(url, { params, ...config }) }
  post(url, data, config) { return this.instance.post(url, data, config }) }
}

const http = new HttpClient({ baseURL: '/api', timeout: 10000 })
const users = await http.get('/users', { page: 1 })

axios.interceptors.response.use(null, async (error) => {
  const config = error.config
  if (!config.__retryCount) config.__retryCount = 0

  const maxRetry = config.retry || 3
  const shouldRetry =
    config.__retryCount < maxRetry &&
    (error.code === 'ECONNABORTED' || !error.response || error.response.status >= 500)

  if (shouldRetry) {
    config.__retryCount++
    // ✅ 指数退避：避免重试风暴
    const delay = 1000 * Math.pow(2, config.__retryCount - 1)
    await new Promise(resolve => setTimeout(resolve, delay))
    return axios(config)
  }

  return Promise.reject(error)
})

// ✅ TypeScript 泛型封装
interface User { id: number; name: string; email: string }
interface ApiResponse<T> { code: number; data: T; message: string }

const response = await http.get<ApiResponse<User[]>>('/users')
// response.data 类型为 User[]