Apifox实战：如何高效设置全局Token实现API自动化测试

1次阅读

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

在 API 自动化测试中，手动管理每个请求的 Token 既低效又容易出错。本文将详细介绍如何在 Apifox 中配置全局 Token，实现测试流程的自动化授权。通过环境变量与脚本的结合，开发者可以一键同步 Token 到所有接口，减少重复劳动并提升测试稳定性。

在现代分布式系统和微服务架构下，API 测试变得愈发复杂。特别是当涉及到身份验证时，每个请求都需要携带有效的 Token。手动为每个请求添加 Token 不仅效率低下，还容易出错。例如：

微服务架构下，每个服务可能有独立的鉴权机制
Token 过期需要频繁手动更新
多环境切换时 Token 需要重新配置

这些痛点使得全局 Token 管理成为 API 自动化测试中必须解决的问题。

在 Apifox 中，有多种方式可以实现 Token 的全局管理，各有优缺点：

请求头注入
优点：简单直接
缺点：需要为每个请求手动添加，无法动态更新
环境变量
优点：一处修改全局生效
缺点：Token 过期需要手动更新
脚本预处理
优点：可以自动获取和更新 Token
缺点：需要编写脚本，有一定学习成本

综合来看，结合环境变量和脚本预处理是最佳方案。

在 Apifox 中打开 ” 环境管理 ”
创建或选择目标环境
添加一个变量如 auth_token，初始值可以留空

在接口或集合的 ”Pre-request Script” 中添加以下代码：

// 获取 Token 的函数
const getToken = async () => {
  try {
    const response = await pm.sendRequest({
      url: 'https://api.example.com/auth',
      method: 'POST',
      header: {'Content-Type': 'application/json'},
      body: {
        mode: 'raw',
        raw: JSON.stringify({username: pm.environment.get('api_username'),
          password: pm.environment.get('api_password')
        })
      }
    });

    const data = response.json();
    if (data.token) {
      // 设置 Token 到环境变量
      pm.environment.set('auth_token', data.token);

      // 设置 Token 过期时间（假设有效期 1 小时）const now = new Date();
      now.setHours(now.getHours() + 1);
      pm.environment.set('token_expires_at', now.getTime());
    }
  } catch (error) {console.error('获取 Token 失败:', error);
  }
};

// 检查 Token 是否存在或过期
const token = pm.environment.get('auth_token');
const expiresAt = pm.environment.get('token_expires_at');
const now = new Date().getTime();

if (!token || !expiresAt || now > expiresAt) {
  // 获取新 Token
  getToken();}

在集合的 ”Auth” 设置中选择 ”Bearer Token”
在 Token 字段中输入 {{auth_token}}（引用环境变量）
这样所有子接口都会自动继承这个配置

以下是一个更完善的 Token 管理脚本，包含了错误处理和自动刷新逻辑：

// 配置项
const AUTH_API = 'https://api.example.com/auth';
const TOKEN_EXPIRY_BUFFER = 300; // 提前 5 分钟刷新

// 获取 Token 的函数
const fetchToken = async () => {
  try {console.log('正在获取新 Token...');

    const response = await pm.sendRequest({
      url: AUTH_API,
      method: 'POST',
      header: {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
      },
      body: {
        mode: 'raw',
        raw: JSON.stringify({username: pm.environment.get('api_username'),
          password: pm.environment.get('api_password')
        })
      }
    });

    const data = response.json();

    if (!data.token) {throw new Error('响应中未包含 Token');
    }

    // 保存 Token 和过期时间
    pm.environment.set('auth_token', data.token);

    // 如果 API 返回 expires_in，使用它；否则默认 1 小时
    const expiresIn = data.expires_in || 3600;
    const expiresAt = new Date().getTime() + (expiresIn * 1000);
    pm.environment.set('token_expires_at', expiresAt);

    console.log('Token 获取成功');
    return data.token;
  } catch (error) {console.error('获取 Token 失败:', error.message);
    throw error;
  }
};

// 检查 Token 状态
const checkToken = () => {const token = pm.environment.get('auth_token');
  const expiresAt = pm.environment.get('token_expires_at');
  const now = new Date().getTime();

  // Token 不存在或已过期
  if (!token || !expiresAt) {return false;}

  // Token 即将过期（在缓冲期内）if (now > expiresAt - (TOKEN_EXPIRY_BUFFER * 1000)) {return false;}

  return true;
};

// 主流程
(async () => {
  try {if (!checkToken()) {await fetchToken();
    }
  } catch (error) {console.error('Token 管理出错:', error.message);
    // 可以在这里添加失败处理逻辑，如发送通知等
  }
})();