本文详解如何通过mvn test -Dxxx=yyy方式向Java测试传递系统属性，并在Cucumber步骤定义中安全获取，避免NullPointerException，同时修正参数化误用导致的Env为null问题。
本文详解如何通过mvn test -dxxx=yyy方式向java测试传递系统属性，并在cucumber步骤定义中安全获取，避免nullpointerexception，同时修正参数化误用导致的env为null问题。
在Cucumber自动化测试中，常需根据运行环境（如Prod、Staging、Dev）动态切换被测URL。许多开发者尝试使用Maven命令行参数（如 -DEnvironment="Prod"）设置系统属性，并在步骤定义中通过 System.getProperty("Environment") 读取——但若步骤方法签名错误地将场景中的占位符 <environment></environment> 映射为形参，就会覆盖真实系统属性值，导致Env为null，进而引发 Cannot invoke "String.contains()" because "Env" is null 错误。
根本原因在于：Cucumber会将Gherkin语句中 <environment></environment> 这类占位符自动绑定为步骤方法的入参。而你的Feature文件写的是：
Given User launch "<Environment>" preflight
对应的方法签名是：
public void launchPreflight(String Env) { ... }此时Cucumber会尝试从场景文本中提取字面量 "Environment"（注意：不是变量名，而是字符串 "Environment"）作为参数传入。但实际场景中该位置并未提供任何值（例如未写成 Given User launch "Prod" preflight），因此Env为null。后续再执行 Env = System.getProperty("Environment") 已无意义——赋值操作发生在null之后，且逻辑上混淆了“参数传入”与“系统属性读取”两种机制。
✅ 正确做法是：解耦场景描述与环境配置。环境信息不应由Gherkin行内传参，而应完全交由外部配置（如Maven参数、profile或properties文件）控制。
修改建议如下：
-
更新Feature文件（移除占位符，使步骤语义更清晰、与环境无关）：
Given User launch Environment preflight
-
更新Step Definition（删除形参，直接读取系统属性，并增强健壮性）：
public void launchPreflight() { 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=Prod (or Dev/Staging)."); } // 统一转小写避免大小写敏感问题 if (env.toLowerCase().contains("prod")) { driver.get(Prod_URL); } else if (env.toLowerCase().contains("dev")) { driver.get(Dev_URL); } else if (env.toLowerCase().contains("staging")) { driver.get(Staging_URL); } else { throw new IllegalArgumentException("Unsupported environment: " + env); } }
⚠️ 注意事项：
-
System.getProperty()仅在JVM启动后有效；确保Maven命令中-D参数位于mvn test之后、-Dcucumber.options=...之前（顺序不影响，但必须存在）； - 建议添加空值校验与明确异常提示，便于CI/CD快速定位配置缺失问题；
- 若需多环境灵活切换，可进一步结合
maven-profiles或application.properties实现分层配置； - 避免在步骤方法中混用“Cucumber参数绑定”和“系统属性读取”，职责必须单一。
通过以上调整，即可安全、清晰地实现命令行驱动的环境化测试执行。
