如何用Java在启动前检查Appium服务器是否已运行

Hey there! I see you’re looking to check if an Appium server is already running before starting it via Java—great idea, that saves you from port conflicts or duplicate server instances. Let’s go through a few reliable methods you can use, paired with your existing code.

Method 1: Port Occupancy Check (Simplest & Cross-Platform) #

Appium defaults to listening on port 4723, so we can check if this port is already in use. This works for any Appium instance (whether started via your code or externally).

Utility Code: #

import java.net.Socket;
import java.io.IOException;

public class AppiumUtils {
    // Default Appium port (adjust if you use a custom port)
    private static final int DEFAULT_APPIUM_PORT = 4723;

    public static boolean isAppiumServerRunning() {
        return isPortInUse(DEFAULT_APPIUM_PORT);
    }

    private static boolean isPortInUse(int port) {
        // Try to connect to the port—success means it's occupied
        try (Socket socket = new Socket("localhost", port)) {
            return true;
        } catch (IOException e) {
            // Connection failed, port is free
            return false;
        }
    }
}

How to Use with Your Code: #

Integrate this check into your startup logic:

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

public class AppiumServiceManager {
    private static AppiumDriverLocalService appiumService;

    public static void startAppium() {
        // Check if server is already running first
        if (AppiumUtils.isAppiumServerRunning()) {
            System.out.println("✅ Appium server is already running on port 4723");
            return;
        }

        // Build and start the service as you normally would
        appiumService = new AppiumServiceBuilder()
                .withAppiumJS(new File("/path/to/your/appium.js")) // Update this path to your appium.js
                .usingPort(4723)
                .withLogFile(new File("appium_execution.log"))
                .build();

        appiumService.start();
        System.out.println("🚀 Appium server started successfully: " + appiumService.getUrl());
    }

    public static void stopAppium() {
        if (appiumService != null && appiumService.isRunning()) {
            appiumService.stop();
            System.out.println("🛑 Appium server stopped");
        }
    }
}

Method 2: Use AppiumDriverLocalService's Built-in Check #

If you only care about Appium instances started by your code, you can use the isRunning() method provided by AppiumDriverLocalService. Note that this won’t detect externally started Appium servers.

Example: #

// Initialize your service instance (keep it as a class-level variable)
AppiumDriverLocalService service = new AppiumServiceBuilder()
        .withAppiumJS(new File("/path/to/appium.js"))
        .usingPort(4723)
        .build();

// Check before starting
if (!service.isRunning()) {
    service.start();
    System.out.println("Appium server started");
} else {
    System.out.println("Appium server managed by this code is already running");
}

Method 3: Check System Processes (Most Accurate) #

To avoid false positives (e.g., another app using port 4723), you can check for actual Appium-related processes via system commands. This works across Windows, macOS, and Linux but requires OS-specific command handling.

Utility Code: #

import java.io.BufferedReader;
import java.io.InputStreamReader;

public class AppiumUtils {
    public static boolean isAppiumProcessRunning() {
        String os = System.getProperty("os.name").toLowerCase();
        String command;

        if (os.contains("win")) {
            // Windows: Look for node.exe processes with "appium" in command line
            command = "tasklist /v /fi \"IMAGENAME eq node.exe\" | findstr /i appium";
        } else if (os.contains("nix") || os.contains("nux") || os.contains("mac")) {
            // Linux/macOS: Look for appium processes (exclude grep itself)
            command = "ps aux | grep -i appium | grep -v grep";
        } else {
            System.out.println("❌ Unsupported operating system");
            return false;
        }

        try {
            Process process = Runtime.getRuntime().exec(command);
            BufferedReader reader = new BufferedReader(new InputStreamReader(process.getInputStream()));
            String line;
            while ((line = reader.readLine()) != null) {
                if (!line.trim().isEmpty()) {
                    return true;
                }
            }
            return false;
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
    }
}

Pro Tip: #

Combine Method 1 and Method 3 for maximum reliability—first check the port, then verify it’s actually an Appium process using the system command check.

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