Java ScheduledService打包为.exe后未运行的问题排查求助

我之前也碰到过类似JavaFX打包后ScheduledService失效的问题，结合你的描述，咱们一步步拆解问题、排查原因：

一、先锁定Executor的核心问题 #

你提到调用start()后getExecutor()返回null，这肯定不正常——默认情况下ScheduledService会初始化一个单线程的Executor，打包后返回null说明默认Executor的初始化流程在打包环境中出了问题。

关于你自定义的Executor，有几个需要调整的点：

1. 设置时机必须在start()之前：确保setExecutor()在start()调用前执行，否则Service会使用默认的（失效的）Executor，后续再设置也不会生效。
2. 改用ScheduledThreadPoolExecutor：你的ThreadPoolExecutor是普通线程池，而ScheduledService是周期性调度任务，用专门的调度线程池更匹配：

// 用单线程调度池足够，因为ScheduledService本身是单任务周期性执行
ScheduledThreadPoolExecutor scheduledExecutor = new ScheduledThreadPoolExecutor(1);
scheduledService.setExecutor(scheduledExecutor);

3. 添加Executor状态日志：在打包后的环境中，打印线程池的实时状态，确认任务是否真的被提交：

// 启动后每隔2秒打印一次线程池状态
new Thread(() -> {
    while (true) {
        System.out.println("Pool size: " + threadPoolExecutor.getPoolSize());
        System.out.println("Queued tasks: " + threadPoolExecutor.getQueue().size());
        System.out.println("Completed tasks: " + threadPoolExecutor.getCompletedTaskCount());
        try { Thread.sleep(2000); } catch (Exception e) {}
    }
}).start();

如果队列里有任务但没被执行，说明线程池的线程被阻塞或者没有被正确唤醒。

二、排查事件线程是否阻塞 #

根据ScheduledService的文档，事件线程（JavaFX Application Thread）繁忙会导致后台任务调度延迟甚至无法触发。你可以这样验证：

1. 给事件线程加心跳日志：用Platform.runLater()定期打印日志，确认事件线程是否存活：

// 每隔1秒打印事件线程状态
ScheduledExecutorService heartBeat = Executors.newSingleThreadScheduledExecutor();
heartBeat.scheduleAtFixedRate(() -> {
    Platform.runLater(() -> {
        System.out.println("Application Thread is alive at " + System.currentTimeMillis());
    });
}, 0, 1, TimeUnit.SECONDS);

如果打包后看不到这条日志，说明事件线程被彻底阻塞了——大概率是应用启动时的初始化代码（比如在start()方法里做了大量同步IO、耗时计算）卡住了事件线程。
2. 检查tick()方法是否阻塞：如果tick()里有耗时操作或者依赖事件线程的代码（比如直接更新UI而没走Platform.runLater()），会导致任务线程阻塞，进而影响下一次调度。

三、打包配置的坑 #

JavaFX Packager打包exe时，很容易因为模块配置不全导致并发组件失效：

1. 确保包含javafx.concurrent模块：如果是模块化项目，module-info.java里必须声明依赖：

module your.module.name {
    requires javafx.controls;
    requires javafx.concurrent; // 必须添加这个
    // 其他依赖...
}

2. 打包时指定正确的模块参数：用javapackager（或jlink/jpackage）打包时，要加上--add-modules javafx.controls,javafx.concurrent，否则打包后的runtime会缺少并发相关的类。
3. 检查JVM参数：打包时有没有设置限制线程的参数？比如-XX:MaxThreads之类的，这会影响Executor的线程创建。

四、添加状态监听定位问题 #

给ScheduledService的状态属性加监听器，打印每一次状态变化，能帮你精准定位卡在哪一步：

scheduledService.stateProperty().addListener((observable, oldState, newState) -> {
    System.out.println("Service state changed: " + oldState + " -> " + newState);
    if (newState == Worker.State.FAILED) {
        // 如果状态变为FAILED，打印异常栈
        scheduledService.getException().printStackTrace();
    }
});

如果状态一直停留在SCHEDULED，说明调度器根本没触发任务执行——要么是Executor没正常工作，要么是JavaFX的内部时钟在打包环境中出现了问题。

五、打包后日志的查看技巧 #

打包成exe后，控制台输出会被隐藏，建议把日志输出到文件：

// 在应用启动时设置日志文件
try {
    File logFile = new File("app_runtime.log");
    System.setOut(new PrintStream(new FileOutputStream(logFile, true)));
    System.setErr(new PrintStream(new FileOutputStream(logFile, true)));
} catch (FileNotFoundException e) {
    e.printStackTrace();
}

这样运行exe后，就能通过app_runtime.log查看所有输出，包括状态变化、Executor日志、异常信息等。

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