编码与格式 / 系统课时
处理超时与任务取消
处理超时与任务取消
本课解决自动化转码长时间不结束、用户主动取消后进程仍占用资源的问题。你将用 Java 托管 FFmpeg 子进程,统一处理超时、手动取消、优雅退出和强制清理,并通过系统命令确认没有残留进程。
学习目标
- 为 FFmpeg 任务设置明确的最长运行时间
- 将超时和手动取消收敛到同一套停止逻辑
- 按“先优雅终止、再强制清理”的顺序回收进程树
先明确取消目标
只调用 Process.destroy() 并不等于任务已经清理完成。FFmpeg 可能仍在刷新输出文件、等待网络 I/O,或者已经启动其他子进程。可靠的取消机制至少要完成四件事:停止接收新工作、向进程树发送终止信号、等待短暂宽限期、对仍存活的进程执行强制终止。
超时和人工取消不应各写一套逻辑。它们只是触发原因不同,最终都应进入同一个幂等的 cancel 方法,避免两个线程同时清理时重复关闭日志流或反复杀进程。

用 Java 托管 FFmpeg 进程
下面的完整示例使用 Java 17 启动一个持续 120 秒的测试任务,但只允许它运行 5 秒。程序持续消费 FFmpeg 输出,防止管道缓冲区写满;超时后先终止已发现的子进程和主进程,等待 3 秒,再强制清理仍存活的进程。
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 秒。
javac FfmpegTimeoutDemo.java
java FfmpegTimeoutDemo 5预期输出:
FFmpeg 已启动,PID=<PID>,超时=5s
达到超时,开始取消任务
任务结束,exitCode=<NON_ZERO><PID> 和 <NON_ZERO> 会因环境而变化。真正的验收条件是任务在设定时间附近结束、日志读取线程退出,并且系统中不再存在本次测试进程。Linux 或 macOS 可继续检查残留进程:
pgrep -af 'ffmpeg.*testsrc2' || true预期输出:
空输出表示没有匹配的 FFmpeg 进程。若仍有残留,应检查运行账号是否有终止权限,以及实际任务是否通过 Shell、脚本或其他工具又创建了新的孙进程。对于不受信任的复杂任务,生产环境可进一步使用 systemd、容器或 cgroup 作为进程组边界。
设计取消接口时的边界
业务层应保存任务 ID、进程句柄和任务状态。取消接口只负责把状态从运行中切换为取消中,并调用同一个幂等清理方法;已经成功、失败或取消的任务再次收到取消请求时,直接返回当前终态。
不要只依赖退出码判断原因。正常失败、超时取消和人工取消都可能得到非零退出码,应在业务状态中单独记录 TIMEOUT、CANCELLED 或 FAILED,同时保留 FFmpeg 最后一段错误日志用于追踪。