本文详解如何在Maven命令行中设置系统属性（如 -DEnvironment="Prod"），并在Cucumber步骤定义中安全获取该值，避免 NullPointerException，同时提供可运行的代码示例与关键注意事项。
本文详解如何在maven命令行中设置系统属性（如 `-denvironment="prod"`），并在cucumber步骤定义中安全获取该值，避免 `nullpointerexception`，同时提供可运行的代码示例与关键注意事项。
在Cucumber自动化测试中，常需根据运行环境（如 Prod、Staging、Dev）动态切换被测URL。许多初学者尝试通过Maven命令行传入系统属性（如 mvn test -DEnvironment="Prod"），再在步骤定义中用 System.getProperty("Environment") 读取——但若步骤方法参数仍声明为形参（如 launchPreflight(String Env)）且Gherkin中使用占位符 <environment></environment>，就会导致参数被Cucumber解析为 null，进而引发 Cannot invoke "String.contains()" because "Env" is null 错误。
根本原因在于：Gherkin中的 <environment></environment> 是场景数据占位符，由Cucumber绑定到方法参数；它与JVM系统属性 Environment 完全无关。当你写成：
Given User launch "<environment>" preflight</environment>
Cucumber会尝试从当前步骤的数据表或示例中提取字符串赋值给 Env 参数——而你并未提供该数据，因此 Env 为 null。此时再执行 Env.contains(...) 必然抛出空指针异常。
✅ 正确做法是：分离关注点
- Gherkin中不依赖占位符传递环境名，改用固定文本（如
Environment）表示语义； - 环境信息完全由系统属性控制，在Java代码中统一通过
System.getProperty()获取； - 同时增强健壮性：判空 + 忽略大小写处理。
以下是推荐实现方式：
✅ 步骤定义（Step Definition）
public void launchPreflight() {
// 设置ChromeDriver路径（建议使用WebDriverManager替代硬编码路径）
System.setProperty("webdriver.chrome.driver", "/chromedriver/chromedriver");
driver = new ChromeDriver();
// 安全读取系统属性
String env = System.getProperty("Environment");
if (env == null || env.trim().isEmpty()) {
throw new RuntimeException("System property 'Environment' is not set. Please run with -DEnvironment=xxx");
}
// 统一转小写，避免大小写敏感问题
if (env.toLowerCase().contains("prod")) {
driver.get(Prod_URL);
} else if (env.toLowerCase().contains("staging")) {
driver.get(Staging_URL);
} else if (env.toLowerCase().contains("dev")) {
driver.get(Dev_URL);
} else {
throw new IllegalArgumentException("Unsupported environment: " + env);
}
}
✅ 对应的Gherkin步骤（Feature文件）
Given User launch Environment preflight When User enters Email as "zzzz" and Password as "zzzz" Then Click on Login When User approves <creativenumber> creative starting from row <startrow> Then the creative should be approved</startrow></creativenumber>
? 提示：
Environment此处仅为自然语言描述，不参与参数绑定，因此不会被Cucumber解析为变量。
⚠️ 关键注意事项
-
不要混用占位符与系统属性：
<environment></environment>和-DEnvironment="Prod"属于两个独立机制，不可互相替代或隐式关联； -
始终校验
System.getProperty()返回值：系统属性未设置时返回null，直接调用.contains()必崩； -
推荐使用
toLowerCase()或equalsIgnoreCase()：避免因PROD/prod/Prod大小写不一致导致逻辑失效； -
进阶建议：使用 WebDriverManager 自动管理驱动版本，替代手动设置
webdriver.chrome.driver； -
Maven命令补充说明：确保
-D参数位于mvn test之后、-Dcucumber.options之前或并列（Maven会合并所有-D属性），例如：mvn test -DEnvironment="Prod" -Dcucumber.options="--name 'Approve Rejected Creative'"
遵循以上结构，即可稳定、清晰地实现“一次编写，多环境运行”的测试配置目标。
