如何在 Java 中稳定调用 SoX 播放网络音频流（如在线电台）-java教程-PHP中文网

如何在 Java 中稳定调用 SoX 播放网络音频流（如在线电台）

本文详解在 Raspberry Pi 上通过 Java 调用 SoX 的 play 命令持续播放网络音频流时进程“静默挂起”的根本原因，并提供基于 ProcessBuilder 与 inheritIO() 的可靠解决方案。

本文详解在 raspberry pi 上通过 java 调用 sox 的 `play` 命令持续播放网络音频流时进程“静默挂起”的根本原因，并提供基于 `processbuilder` 与 `inheritio()` 的可靠解决方案。

在 Java 中调用外部音频工具（如 SoX 的 play）播放网络电台流（例如 play --magic http://example.com/stream.mp3）时，看似简单，却极易因标准流阻塞导致播放数分钟后无声中断——进程仍在运行，但 waitFor() 不返回、无异常、错误流为空。该问题在 Raspberry Pi 4B（Raspberry Pi OS）上尤为典型，根源并非网络或音频设备故障，而是 Java 子进程的 I/O 缓冲区管理不当。

根本原因：子进程的标准输出/错误流未及时消费

SoX 在播放过程中会持续向 stdout 和 stderr 输出调试信息（如采样率、缓冲状态、解码进度等）。当 Java 使用 Runtime.getRuntime().exec() 启动进程却未主动读取这些流时，操作系统内核的管道缓冲区（通常为 64KB）会被迅速填满。一旦写满，SoX 进程将被内核挂起（SIGSTOP 级别阻塞），无法继续读取音频流或推进解码，表现为“无声但进程存活”。而 p.waitFor() 因进程未正常退出，永远阻塞。

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

正确方案：使用 ProcessBuilder 并启用 inheritIO()

ProcessBuilder 是 Java 推荐的现代进程启动 API，其 inheritIO() 方法可将子进程的 stdin/stdout/stderr 直接重定向至 JVM 当前进程的对应流（即控制台），彻底规避缓冲区溢出风险：

import java.io.IOException;

public class SoxPlayer {
    public static void playStream(String stationUrl) throws IOException, InterruptedException {
        ProcessBuilder builder = new ProcessBuilder("play", "--magic", stationUrl);
        // 关键：继承父进程的标准 I/O，避免缓冲区阻塞
        builder.inheritIO();
        // 设置环境变量（替代 Runtime.exec 的 envp 参数）
        builder.environment().put("AUDIODEV", "pcm.radsound");

        Process process = builder.start();
        // 非阻塞式等待（推荐）或按需 waitFor()
        int exitCode = process.waitFor();
        System.out.println("SoX exited with code: " + exitCode);
    }
}

注意事项与增强建议

环境变量作用域：builder.environment().put() 修改的是子进程环境，不影响 JVM 本身；确保 pcm.radsound 设备在 Pi 上已正确配置（可通过 aplay -L 验证）。
避免 waitFor() 阻塞主线程：生产环境中建议在独立线程中调用 waitFor()，或使用 process.onExit().thenAccept(...)（Java 9+）实现异步监听。

超时保护（推荐）：为防止意外卡死，可结合 Future 或 ExecutorService 添加超时机制：

Future> future = executor.submit(() -> process.waitFor());
try {
    future.get(30, TimeUnit.SECONDS); // 最多等待30秒
} catch (TimeoutException e) {
    process.destroyForcibly(); // 强制终止
    throw new RuntimeException("SoX playback timed out", e);
}