Apifox全局配置Token的实战指南：从原理到最佳实践

1次阅读

共计 1866 个字符，预计需要花费 5 分钟才能阅读完成。

在 API 开发和测试过程中，手动管理 Token 是许多开发者面临的常见问题。这不仅效率低下，还容易引发一系列问题：

低效性 ：每次调用 API 都需要手动粘贴 Token，浪费大量时间
不一致性 ：团队成员可能使用不同 Token，导致测试结果不一致
安全性风险 ：Token 可能通过聊天工具或邮件传播，增加泄露风险
过期管理困难 ：无法及时获知 Token 过期，影响测试流程

Apifox 通过环境管理和变量机制实现 Token 的全局配置：

变量作用域 ：
环境变量：针对特定环境（如开发、测试、生产）
全局变量：跨环境共享的变量
本地变量：仅在当前请求有效的变量
变量优先级 ：
本地变量 > 环境变量 > 全局变量
冲突时优先使用更高优先级的变量

配置方式	适用场景	优点	缺点
环境变量	多环境部署	环境隔离性好	需要维护多套配置
全局变量	通用配置	维护简单	缺乏环境隔离
本地变量	临时测试	灵活	无法共享

打开 Apifox，进入项目设置
选择 ” 全局变量 ” 选项卡
添加新变量，例如：
变量名：access_token
变量值：你的 Token 值
保存设置

// 获取全局 Token 示例
const getGlobalToken = () => {
  // 从 Apifox 全局变量获取 Token
  const token = pm.globals.get('access_token');

  // 验证 Token 有效性
  if (!token || token === '') {console.error('未获取到有效 Token');
    return null;
  }

  return token;
};

// 使用示例
const apiRequest = (url, method = 'GET') => {const token = getGlobalToken();

  return fetch(url, {
    method,
    headers: {'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    }
  });
};

创建预请求脚本：

// 在需要 Token 的请求前添加 Pre-request Script
const refreshToken = () => {
  const refreshUrl = 'https://api.example.com/auth/refresh';
  const refreshToken = pm.globals.get('refresh_token');

  pm.sendRequest({
    url: refreshUrl,
    method: 'POST',
    header: {'Content-Type': 'application/json'},
    body: {
      mode: 'raw',
      raw: JSON.stringify({refresh_token: refreshToken})
    }
  }, (err, response) => {if (!err) {const data = response.json();
      pm.globals.set('access_token', data.access_token);
      pm.globals.set('refresh_token', data.refresh_token);
    }
  });
};

设置定时任务：

// 检查 Token 有效期
const checkTokenExpiry = () => {const expiresAt = pm.globals.get('token_expires_at');
  if (new Date(expiresAt) < new Date()) {refreshToken();
  }
};