Kotlin项目中RestAssured测试集成Cucumber生成报告及导入冲突解决方案

完全可以在基于Gradle构建的Kotlin项目中成功配置RestAssured与Cucumber-JVM的集成环境，你遇到的同名方法冲突属于Kotlin导入命名冲突，可通过以下方案解决：

核心解决方案：导入时重命名冲突方法 #

Kotlin支持导入类/函数时通过as关键字自定义别名，直接区分同名的Cucumber步骤定义函数和RestAssured扩展函数即可。推荐将RestAssured的扩展函数重命名，避免修改Cucumber的原生步骤写法，示例代码如下：

@file:Suppress("ClassName")

package org.restassured.tests

import io.cucumber.java8.En
import io.cucumber.junit.Cucumber
import io.cucumber.junit.CucumberOptions
// 导入RestAssured扩展时重命名，避免和Cucumber的同名方法冲突
import io.restassured.module.kotlin.extensions.Given as raGiven
import io.restassured.module.kotlin.extensions.Then as raThen
import io.restassured.module.kotlin.extensions.When as raWhen
import org.hamcrest.Matchers.equalTo
import org.junit.runner.RunWith
import org.restassured.BaseTest

@RunWith(Cucumber::class)
@CucumberOptions(
    features = ["src/test/resources/features"],
    publish = true,
    plugin = ["pretty", "html:build/cucumber-report.html"] // 配置生成HTML格式的Cucumber报告
)
class CucumberTest : En, BaseTest() {
    init {
        Given("a category Fresh exists") {
            // 可在此处做前置数据准备等操作
        }

        When("a user calls the category list API") {
            // 调用RestAssured接口，使用重命名后的扩展方法
            raGiven {
                spec(requestSpecification)
            } raWhen {
                get("/categories/")
            } raThen {
                statusCode(200)
            }
        }

        Then("the status code is 200 and the first category is Fresh") {
            // 也可将响应存在类变量中，实现跨步骤断言
            raThen {
                body("categories.name[0]", equalTo("Fresh"))
                body("categories.category_url[1]", equalTo("/shop/categories/Fruits"))
            }
        }
    }
}

补充配置说明 #

• 依赖配置：你的build.gradle.kts中需要同时引入Cucumber相关依赖和RestAssured Kotlin扩展依赖，示例配置片段如下：

  dependencies {
      // Cucumber 依赖
      testImplementation("io.cucumber:cucumber-java8:7.14.0")
      testImplementation("io.cucumber:cucumber-junit:7.14.0")
      // RestAssured 依赖
      testImplementation("io.rest-assured:rest-assured:5.3.2")
      testImplementation("io.rest-assured:kotlin-extensions:5.3.2")
      // 其他你需要的JUnit、序列化依赖等
  }
  

• 执行测试后，会在你配置的plugin路径下生成Cucumber报告，同时支持原生Cucumber的所有特性。

替代方案 #

如果不想使用重命名方案，也可以放弃RestAssured的Kotlin扩展语法，使用传统Java风格的RestAssured写法，不会出现命名冲突，不过代码可读性略低于Kotlin扩展写法：

// 传统写法示例
RestAssured.given()
    .spec(requestSpecification)
    .`when`()
    .get("/categories/")
    .then()
    .statusCode(200)

内容的提问来源于stack exchange，提问作者Utku Türel