编码与格式 / 系统课时

处理超时与任务取消

处理超时与任务取消

本课解决自动化转码长时间不结束、用户主动取消后进程仍占用资源的问题。你将用 Java 托管 FFmpeg 子进程,统一处理超时、手动取消、优雅退出和强制清理,并通过系统命令确认没有残留进程。

学习目标

  • 为 FFmpeg 任务设置明确的最长运行时间
  • 将超时和手动取消收敛到同一套停止逻辑
  • 按“先优雅终止、再强制清理”的顺序回收进程树

先明确取消目标

只调用 Process.destroy() 并不等于任务已经清理完成。FFmpeg 可能仍在刷新输出文件、等待网络 I/O,或者已经启动其他子进程。可靠的取消机制至少要完成四件事:停止接收新工作、向进程树发送终止信号、等待短暂宽限期、对仍存活的进程执行强制终止。

超时和人工取消不应各写一套逻辑。它们只是触发原因不同,最终都应进入同一个幂等的 cancel 方法,避免两个线程同时清理时重复关闭日志流或反复杀进程。

FFmpeg 任务取消与进程树清理流程

用 Java 托管 FFmpeg 进程

下面的完整示例使用 Java 17 启动一个持续 120 秒的测试任务,但只允许它运行 5 秒。程序持续消费 FFmpeg 输出,防止管道缓冲区写满;超时后先终止已发现的子进程和主进程,等待 3 秒,再强制清理仍存活的进程。

java
import java.io.BufferedReader;
import java.io.IOException;
import java.time.Duration;
import java.util.List;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.Future;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicBoolean;

public final class FfmpegTimeoutDemo {
    public static void main(String[] args) throws Exception {
        Duration timeout = Duration.ofSeconds(args.length > 0
                ? Long.parseLong(args[0]) : 5);

        List<String> command = List.of(
                "ffmpeg", "-hide_banner", "-loglevel", "warning",
                "-re", "-f", "lavfi",
                "-i", "testsrc2=size=1280x720:rate=30",
                "-t", "120", "-f", "null", "-"
        );

        Process process = new ProcessBuilder(command)
                .redirectErrorStream(true)
                .start();

        ExecutorService logExecutor = Executors.newSingleThreadExecutor();
        Future<?> logTask = logExecutor.submit(() -> {
            try (BufferedReader reader = process.inputReader()) {
                reader.lines().forEach(System.out::println);
            } catch (IOException e) {
                System.err.println("日志读取失败:" + e.getMessage());
            }
        });

        AtomicBoolean stopping = new AtomicBoolean(false);
        Runnable cancel = () -> stopTree(
                process, Duration.ofSeconds(3), stopping
        );

        // JVM 被关闭时也复用同一套清理逻辑。
        Runtime.getRuntime().addShutdownHook(
                new Thread(cancel, "ffmpeg-shutdown")
        );

        System.out.printf(
                "FFmpeg 已启动,PID=%d,超时=%ds%n",
                process.pid(), timeout.toSeconds()
        );

        boolean finished = process.waitFor(
                timeout.toMillis(), TimeUnit.MILLISECONDS
        );
        if (!finished) {
            System.out.println("达到超时,开始取消任务");
            cancel.run();
        }

        int exitCode = process.waitFor();
        logTask.get(2, TimeUnit.SECONDS);
        logExecutor.shutdownNow();
        System.out.println("任务结束,exitCode=" + exitCode);
    }

    private static void stopTree(
            Process process,
            Duration grace,
            AtomicBoolean stopping
    ) {
        // 保证超时、接口取消和关闭钩子只能有一个执行清理。
        if (!stopping.compareAndSet(false, true)) {
            return;
        }

        List<ProcessHandle> descendants =
                process.toHandle().descendants().toList();

        descendants.forEach(ProcessHandle::destroy);
        process.destroy();

        try {
            if (!process.waitFor(
                    grace.toMillis(), TimeUnit.MILLISECONDS
            )) {
                descendants.stream()
                        .filter(ProcessHandle::isAlive)
                        .forEach(ProcessHandle::destroyForcibly);
                process.destroyForcibly();
            }
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
            descendants.stream()
                    .filter(ProcessHandle::isAlive)
                    .forEach(ProcessHandle::destroyForcibly);
            process.destroyForcibly();
        }
    }
}

预期结果:程序会在超时后进入取消流程,最终打印非零退出码。退出码受操作系统和 FFmpeg 构建影响,因此不要把某个固定数字作为取消成功的唯一判断。

运行并验证

将代码保存为 FfmpegTimeoutDemo.java,确认 ffmpeg 已加入 PATH,然后编译并运行。命令行参数 5 表示最长运行 5 秒。

bash
javac FfmpegTimeoutDemo.java
java FfmpegTimeoutDemo 5

预期输出:

text
FFmpeg 已启动,PID=<PID>,超时=5s
达到超时,开始取消任务
任务结束,exitCode=<NON_ZERO>

<PID> 和 <NON_ZERO> 会因环境而变化。真正的验收条件是任务在设定时间附近结束、日志读取线程退出,并且系统中不再存在本次测试进程。Linux 或 macOS 可继续检查残留进程:

bash
pgrep -af 'ffmpeg.*testsrc2' || true

预期输出:

text

空输出表示没有匹配的 FFmpeg 进程。若仍有残留,应检查运行账号是否有终止权限,以及实际任务是否通过 Shell、脚本或其他工具又创建了新的孙进程。对于不受信任的复杂任务,生产环境可进一步使用 systemd、容器或 cgroup 作为进程组边界。

设计取消接口时的边界

业务层应保存任务 ID、进程句柄和任务状态。取消接口只负责把状态从运行中切换为取消中,并调用同一个幂等清理方法;已经成功、失败或取消的任务再次收到取消请求时,直接返回当前终态。

不要只依赖退出码判断原因。正常失败、超时取消和人工取消都可能得到非零退出码,应在业务状态中单独记录 TIMEOUT、CANCELLED 或 FAILED,同时保留 FFmpeg 最后一段错误日志用于追踪。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理超时与任务取消

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通