通过代码启动Appium Server触发NullPointerException问题求助

问题原因分析 #

这个NullPointerException触发在service.stop()调用环节，核心原因是**AppiumDriverLocalService实例service为null**：

• 在configureAppium方法的try块中，若service.start()抛出异常，代码仅打印堆栈但未处理service的状态；极端情况下buildService返回null，也会导致service未完成初始化。
• 后续tearDown方法直接调用service.stop()，就会触发空指针异常。

而测试代码能正常执行，说明实际连接的Appium服务并非代码启动的实例（比如之前手动启动的服务未关闭、端口4723已有其他进程占用），因此测试流程不受影响，但代码启动的服务实例逻辑存在漏洞。

修复步骤 #

1. 快速修复：给tearDown加空指针判断

修改tearDown方法，确保仅在service有效且运行时才执行停止操作：

@AfterClass
public void tearDown() {
    driver.quit();
    if (service != null && service.isRunning()) {
        service.stop();
    }
}

2. 优化异常处理逻辑

不要仅捕获异常打印堆栈，需明确处理服务启动失败的场景，避免后续流程依赖无效实例：

try {
    service = AppiumDriverLocalService.buildService(builder);
    service.start();
    // 验证服务是否成功启动
    if (!service.isRunning()) {
        throw new RuntimeException("Appium服务启动失败");
    }
} catch (Exception e) {
    e.printStackTrace();
    // 启动失败时直接抛出异常，终止测试流程
    throw new RuntimeException("配置Appium服务出错", e);
}

3. 检查基础配置有效性

• 确认builder.withAppiumJS指定的路径是否正确：手动打开C:\\Users\\Admin\\AppData\\Roaming\\npm\\node_modules\\appium\\build\\lib\\main.js路径，验证文件是否存在
• 检查端口4723是否被占用：命令行执行netstat -ano | findstr :4723，若有结果则杀掉对应进程后重试，或更换为4724等其他端口
• 清理冗余代码：删掉重复创建AppiumServiceBuilder的行

  // 删除此行重复代码
  // builder = new AppiumServiceBuilder();
  

4. 简化服务启动方式（可选）

尽量使用Appium默认服务启动逻辑，避免手动指定路径的潜在问题：

service = AppiumDriverLocalService.buildDefaultService();
service.start();

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