如何更新karate-config.js中全局Auth Token变量？解决过期刷新问题

1. 封装Token获取/刷新的可复用场景 #

先编写一个common.feature，统一处理Token的获取与刷新逻辑，确保所有测试场景都能调用：

Feature: 通用Token管理

  Scenario: 获取/刷新Auth Token
    Given url 'https://你的认证服务器地址/token'
    And form field grant_type = 'client_credentials'
    And form field client_id = karate.properties['client.id']
    And form field client_secret = karate.properties['client.secret']
    When method post
    Then status 200
    * def authToken = response.access_token
    * karate.configure('headers', { Authorization: 'Bearer ' + authToken })
    * return authToken

2. 在karate-config.js中初始化全局Token并预留刷新入口 #

不要直接硬编码Token，通过调用上述场景完成初始化，同时将刷新方法挂载到全局配置，方便后续触发：

function fn() {
  var config = {
    // 其他业务配置项
  };
  // 初始化Token
  var token = karate.call('classpath:common.feature@获取/刷新Auth Token');
  config.authToken = token;
  // 全局刷新Token方法
  config.refreshToken = function() {
    var newToken = karate.call('classpath:common.feature@获取/刷新Auth Token');
    config.authToken = newToken;
    return newToken;
  };
  return config;
}

3. 利用重试机制自动处理401过期场景 #

通过Karate的retry关键字，在请求返回401时触发Token刷新并重试原请求，可实现全局生效：

Feature: 业务API测试

  Background:
    * url 'https://你的业务API服务器地址'
    * configure retry = { count: 1, interval: 0 }

  Scenario: 获取用户信息
    Given path '/users/me'
    When method get
    Then status 200
    * if (responseStatus == 401) {
        karate.call('classpath:common.feature@获取/刷新Auth Token');
        retry();
      }

4. 全局请求钩子的简化实现 #

如果想让所有请求自动处理401，可在karate-config.js中配置beforeRequest钩子，无需在每个场景中重复编写重试逻辑：

function fn() {
  var config = {
    baseUrl: 'https://你的业务API服务器地址'
  };
  // 初始化Token
  var token = karate.call('classpath:common.feature@获取/刷新Auth Token');
  karate.configure('headers', { Authorization: 'Bearer ' + token });
  
  // 全局请求钩子，处理401刷新
  karate.configure('beforeRequest', function() {
    var request = karate.get('request');
    // 跳过Token接口本身，避免死循环
    if (!request.url.includes('/token')) {
      var responseStatus = karate.get('responseStatus');
      if (responseStatus == 401) {
        var newToken = karate.call('classpath:common.feature@获取/刷新Auth Token');
        karate.configure('headers', { Authorization: 'Bearer ' + newToken });
        karate.retry();
      }
    }
  });
  
  return config;
}

关键注意事项 #

• 必须跳过Token接口的重试逻辑，防止出现刷新Token时返回401导致的死循环
• 客户端ID、密钥等敏感信息建议通过外部配置文件传入karate.properties，避免硬编码
• 重试次数设置为1即可，仅需刷新一次Token后重试原请求

内容的提问来源于stack exchange，提问作者Smitha