以编程方式启动Appium Service失败，仅手动启动可正常运行

嘿，我之前踩过类似的Appium自动启动失效的坑，结合你描述的情况——9个月没碰的项目，手动启动桌面版能跑但代码自动启动不行，咱们一步步来排查解决：

首先先明确你的核心问题：

有个9个月前创建的Appium测试项目，此前运行状态正常。近期重新启用该项目时发现，仅通过桌面应用手动启动Appium后，项目才能正常运行。项目原本会检查服务器是否已运行，若未运行则通过以下服务逻辑启动：

public class AppiumServer { 
    AppiumDriverLocalService service = null; 
    public void InitAppiumServer() { 
        System.out.println("Creating Appium Servi...");
        // 原代码后续启动逻辑可能缺失或失效
    }
}

1. 版本不兼容是重灾区 #

9个月时间Appium生态更新挺多的，你手动启动的桌面端Appium版本，大概率和项目依赖的Appium Java Client版本不匹配了——桌面端是你现在装的新版本，但项目里还是旧依赖，导致自动启动逻辑跑不起来。

• 修复步骤：
  • 打开桌面Appium，首页就能看到当前版本（比如Appium 2.0+）
  • 打开项目的依赖配置文件：
    • Maven项目改pom.xml里的io.appium:java-client版本，Appium 2.x对应java-client 8.x及以上，Appium 1.x对应java-client 7.x
    • Gradle项目改build.gradle里的对应依赖版本
  • 刷新依赖，重新构建项目

2. 自动启动代码不完整/配置失效 #

你贴的InitAppiumServer方法只有打印语句，完整的自动启动逻辑需要指定Appium执行文件路径、端口、日志等关键配置，可能之前的代码有遗漏，或者现在环境变了路径不对。

给你补一个完整的可运行示例：

import io.appium.java_client.service.local.AppiumDriverLocalService;
import io.appium.java_client.service.local.AppiumServiceBuilder;
import java.io.File;

public class AppiumServer { 
    AppiumDriverLocalService service = null; 

    public void InitAppiumServer() { 
        System.out.println("Creating Appium Service...");
        // 替换成你本地Appium的实际路径
        // Windows示例：桌面版Appium的main.js路径
        File appiumExecutable = new File("C:\\Program Files\\Appium\\resources\\app\\node_modules\\appium\\build\\lib\\main.js");
        // Mac示例：通过npm安装的Appium路径
        // File appiumExecutable = new File("/usr/local/lib/node_modules/appium/build/lib/main.js");

        // 构建服务配置
        AppiumServiceBuilder builder = new AppiumServiceBuilder()
                .usingPort(4723) // 和手动启动的端口保持一致，避免冲突
                .withAppiumJS(appiumExecutable)
                .withLogFile(new File("appium-server.log")); // 生成日志，方便排查启动失败原因

        // 启动服务
        service = AppiumDriverLocalService.buildService(builder);
        service.start();

        // 校验启动状态
        if (service.isRunning()) {
            System.out.println("Appium Server启动成功，端口：" + service.getUrl().getPort());
        } else {
            throw new RuntimeException("自动启动Appium Server失败，请检查配置");
        }
    }

    // 测试结束后记得停止服务，避免端口占用
    public void stopAppiumServer() {
        if (service != null && service.isRunning()) {
            service.stop();
        }
    }
}

3. 环境变量或权限问题 #

手动启动桌面Appium是用当前用户的完整权限和环境变量，但代码启动时可能没拿到正确的配置——比如找不到Node.js路径（Appium依赖Node），或者权限不足无法启动服务。

• 修复：
  • 检查系统环境变量里是否有NODE_PATH，且Appium的安装路径已加入环境变量
  • Windows用户可以右键以管理员身份运行IDE/测试脚本；Mac/Linux用户确保执行用户有Appium路径的读写权限

4. 端口占用或冲突 #

有时候代码指定的端口被其他程序占用，但手动启动桌面端时Appium会自动切换可用端口，所以能成功运行。

• 修复：改成让Appium自动选择可用端口：

AppiumServiceBuilder builder = new AppiumServiceBuilder()
        .withAppiumJS(appiumExecutable)
        .usingAnyFreePort(); // 自动找空闲端口

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