本地Appium服务未启动异常：如何用Java程序化启动服务？

我之前在Win7 x64环境下用Java程序化启动Appium时也踩过这个坑，结合你的场景给你几个针对性的排查和解决方法：

1. 补全Appium服务启动的完整代码 #

你的代码片段没写完，大概率是缺少了指定Appium核心脚本路径和启动服务的关键步骤。Win7下AppiumServiceBuilder无法自动识别启动入口，必须手动指定：

import io.appium.java_client.service.local.AppiumDriverLocalService;
import io.appium.java_client.service.local.AppiumServiceBuilder;
import org.openqa.selenium.remote.DesiredCapabilities;
import java.io.File;

public void startServer() {
    // 设置基础配置
    DesiredCapabilities cap = new DesiredCapabilities();
    cap.setCapability("noReset", "false");

    // 构建Appium服务实例
    AppiumServiceBuilder builder = new AppiumServiceBuilder();
    builder.withIPAddress("127.0.0.1");
    builder.usingPort(4723);
    builder.withCapabilities(cap);
    // 重点：指定Appium的main.js路径，根据你的实际安装位置调整
    builder.withAppiumJS(new File("C:\\Program Files (x86)\\Appium\\resources\\app\\node_modules\\appium\\build\\lib\\main.js"));

    // 启动服务并验证状态
    AppiumDriverLocalService service = AppiumDriverLocalService.buildService(builder);
    service.start();
    
    if (service.isRunning()) {
        System.out.println("Appium服务启动成功");
    } else {
        throw new RuntimeException("Appium服务启动失败，请检查路径和配置");
    }
}

2. 检查端口占用情况 #

4723是Appium默认端口，很可能被其他进程占用。打开CMD执行以下命令排查：

netstat -ano | findstr :4723

如果返回结果中有进程ID，打开任务管理器杀掉对应进程，或者在代码中更换端口（比如builder.usingPort(4724)）。

3. 配置Appium相关环境变量 #

Win7下需要把Appium依赖的node.exe路径加入系统环境变量PATH：

• 找到你的Appium安装目录，比如C:\Program Files (x86)\Appium
• 将该目录下的node.exe所在路径（通常就是安装根目录）添加到系统PATH中
• 重启你的IDE或命令行工具，确保环境变量生效

4. 以管理员身份运行程序 #

Win7的UAC权限限制可能导致Java程序无法启动外部服务，右键点击你的IDE或Java可执行文件，选择以管理员身份运行再尝试启动服务。

5. 先手动验证Appium可用性 #

先打开Appium桌面客户端，手动启动服务，然后运行你的自动化测试代码：

• 如果手动启动能正常运行，说明问题出在程序化启动的代码配置上，回到第一步检查路径和启动逻辑
• 如果手动启动也报错，建议重新安装Appium（注意版本要和你的Appium Java Client版本匹配）

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