Selenium Webdriver Java测试cmd可运行Jenkins启动失败问题排查求助

根因定位 #

从报错堆栈可以直接定位到问题：TestDataReader类初始化时，System.getProperty("environment")返回了null，传入ResourceBundle.getBundle()后触发了JDK内部的空指针异常，导致类初始化失败。
本地运行正常、Jenkins运行失败，常见的几个原因和对应的解决方法如下：

排查&解决步骤 #

• 第一步：确认Jenkins参数配置正确
  检查Jenkins任务的参数化配置项，确认存在名为environment的参数，可选值/默认值和你本地用的配置文件名完全一致（不需要加.properties后缀），执行流水线时没有漏填该参数。
  如果是声明式Jenkins Pipeline，注意参数引用语法是${params.environment}，直接写${environment}会取不到值，导致传空。
• 第二步：确认Maven命令参数顺序正确
  你给出的命令片段缺少mvn前缀，完整执行命令应该为：

  mvn -Dbrowser=${browser} -Dsurefire.suiteXmlFiles=${surefire.suiteXmlFiles} -Denvironment=${environment} clean test
  

  所有-D开头的系统参数必须放在clean test前面，否则不会被JVM识别。
• 第三步：确认资源文件匹配部署环境规则
  如果Jenkins部署在Linux服务器上，文件名是大小写敏感的，本地Windows环境大小写不敏感，很容易出现本地能读、服务器读不到的问题。要确保src/main/resources或src/test/resources下的配置文件名和environment参数的值大小写完全一致，后缀为.properties。

临时调试方案 #

可以修改TestDataReader代码增加空值判断，避免模糊的空指针报错，方便定位问题：

public class TestDataReader {
    private static final ResourceBundle resourceBundle;
    static {
        String env = System.getProperty("environment");
        if (env == null || env.trim().isEmpty()) {
            throw new RuntimeException("environment系统参数为空，请检查Jenkins参数传递是否正确");
        }
        resourceBundle = ResourceBundle.getBundle(env);
    }

    public static String getTestData(String key) {
        return resourceBundle.getString(key);
    }
}

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