如何通过Jenkins或Maven命令向Karate传递环境变量

DevOps 小满

2026-7-18

解决Karate框架通过Maven/Jenkins传递凭据失效的问题

问题根源

你在karate-config.js里用system.get.env()读取的是系统环境变量，但通过Maven命令-D参数传递的是JVM系统属性，两者不属于同一类配置，所以在Maven或Jenkins环境下无法读取到对应值。

修复步骤

修改karate-config.js的变量读取逻辑，改用Karate提供的karate.properties.get()方法读取JVM参数：

function fn() {
  var config = {
    dbUserId: karate.properties.get('dbuserId'),
    dbUserPassword: karate.properties.get('dbUserPassword')
  };
  // 可选：兼容环境变量场景，同时支持两种传参方式
  if (!config.dbUserId) {
    config.dbUserId = system.getenv('DB_USER_ID');
  }
  if (!config.dbUserPassword) {
    config.dbUserPassword = system.getenv('DB_USER_PASSWORD');
  }
  return config;
}

Maven命令无需调整，继续使用-D传递参数：

mvn test -Dtest=abc -DdbuserId=efg -DdbUserPassword=hij

Jenkins流水线传参方式
直接在sh步骤中传递-D参数即可：

stage('Run Karate Tests') {
  steps {
    sh 'mvn test -Dtest=abc -DdbuserId=efg -DdbUserPassword=hij'
  }
}

若要避免明文传递，可结合Jenkins凭据管理：

stage('Run Karate Tests') {
  environment {
    DB_USER_ID = credentials('db-user-id')
    DB_USER_PASSWORD = credentials('db-user-password')
  }
  steps {
    sh 'mvn test -Dtest=abc -DdbuserId=${DB_USER_ID} -DdbUserPassword=${DB_USER_PASSWORD}'
  }
}