基于Karate框架的UI/API自动化测试项目测试数据管理最佳实践咨询

针对你遇到的UI与API测试数据重复问题，结合Karate的特性，以下是可落地的测试数据架构优化方案：

1. 重构目录结构：按数据类型而非功能分层 #

放弃按功能文件夹分散存放数据的方式，统一将测试数据抽离到独立的test-data目录，按数据复用层级拆分：

src/test/resources/
├── test-data/
│   ├── base/          # 通用基础数据（全场景复用）
│   │   ├── user-default.json
│   │   └── product-base.json
│   ├── business/      # 业务模块数据（某类业务通用）
│   │   ├── order-shared.json
│   │   └── checkout-common.json
│   └── scenarios/     # 特定场景数据（仅单一测试流程用）
│       ├── ui-checkout-flow.json
│       └── api-order-creation.json
├── env/               # 统一环境配置（替代各功能文件夹的环境JSON）
│   ├── dev.json
│   ├── staging.json
│   └── prod.json
├── api/               # API测试用例
├── ui/                # UI测试用例
└── karate-config.js

2. 利用Karate原生能力实现数据复用 #

（1）跨场景读取公共数据 #

通过Karate的read()方法，UI和API测试可以直接引用同一数据源，无需重复定义：

# API测试中引用基础用户数据
Feature: 创建订单
Background:
* def user = read('classpath:test-data/base/user-default.json')
* def token = call read('classpath:utils/api-auth.feature') user

# UI测试中复用同一用户数据
Feature: 结账流程
Background:
* def user = read('classpath:test-data/base/user-default.json')
* call read('classpath:utils/ui-login.feature') user

（2）环境变量动态替换 #

在公共数据中使用占位符，通过karate-config.js加载对应环境的配置，实现一套数据适配多环境：

// test-data/base/user-default.json
{
  "username": "test_user_#(karate.uuid())",
  "email": "#(username)@#(env.domain)",
  "password": "TestPass_#(karate.randomNumber(4))"
}

// karate-config.js
function fn() {
  var env = karate.env || 'dev';
  var config = {
    env: env,
    domain: env === 'dev' ? 'dev.example.com' : 'prod.example.com'
  };
  return config;
}

（3）动态生成数据避免硬编码 #

用Karate内置函数或自定义工具生成动态数据，减少固定数据的重复维护：

# utils/data-generator.feature
Feature: 动态数据生成工具
Scenario: 生成随机用户
* def generateUser = function(){
    return {
      username: 'user_' + karate.uuid(),
      phone: '13' + karate.randomNumber(9)
    }
  }

# UI/API测试中调用生成函数
* def randomUser = call read('classpath:utils/data-generator.feature').generateUser

3. 分层复用：避免场景数据冗余 #

• 基础层：存放无业务关联的通用数据（如默认用户、基础商品信息）
• 业务层：存放某类业务的共享数据（如订单必填字段模板），可引用基础层数据
• 场景层：存放特定测试流程的个性化数据，仅补充业务层未覆盖的字段

示例：

// test-data/business/order-shared.json
{
  "user": read('classpath:test-data/base/user-default.json'),
  "amount": 99.9,
  "status": "pending"
}

// test-data/scenarios/api-order-creation.json
{
  "order": read('classpath:test-data/business/order-shared.json'),
  "couponCode": "API_TEST_20OFF" // 仅API测试需要的字段
}

4. 公共步骤与数据绑定 #

将UI/API共有的业务流程（如登录、获取权限令牌）抽离成公共feature，同时绑定对应数据，测试用例只需调用该feature即可复用数据和步骤：

# utils/api-auth.feature
Feature: API登录获取令牌
Scenario: 登录
Given url env.baseUrl + '/auth/login'
And request { username: '#(username)', password: '#(password)' }
When method post
Then status 200
* def token = response.data.token

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