Java调用FFmpeg应优先使用JavaCV而非Runtime.exec()，因其通过JNI封装FFmpeg C接口，避免进程卡死、乱码、路径问题及资源泄漏；Maven引入javacv-platform可自动加载native库，需注意平台classifier匹配，初始化后须调用start()并校验帧率。
Java 里调用 FFmpeg，别直接 exec，用 JavaCV 更稳
Java 自己没原生音视频处理能力，硬写 Runtime.getRuntime().exec() 调 FFmpeg 命令，看似简单，实则埋雷：进程卡死、标准输出乱码、Windows 路径空格崩、资源不释放。JavaCV 是 OpenCV 的 Java 封装，但关键在于它把 FFmpeg 的 C 接口做了 JNI 封装，能直接操作帧、编解码器、格式上下文，跳过 shell 层。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 用 Maven 引入
org.bytedeco:javacv-platform（含预编译 native 库），不是只引javacv单模块 - 避免手动下载 FFmpeg.exe 或设置
ffmpeg.location系统属性——JavaCV 会自动加载自带的 native 二进制，设了反而可能冲突 - Windows 下若报
UnsatisfiedLinkError: no jniopencv_core in java.library.path，大概率是平台 classifier 没对上，检查依赖是否带win-x86_64后缀
读取视频帧时卡在 grab()，多半是格式或线程问题
FrameGrabber 的 grab() 方法阻塞，常见于 MP4/H.264 容器 + B-frame 场景，或在非主线程反复调用未重置状态。JavaCV 默认用 FFmpeg 后端，但底层 AVFormatContext 初始化失败不会立刻抛异常，而是让后续 grab() 返回 null 或死等。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 初始化后立刻调
grabber.start()，不要跳过；抓帧前加if (grabber.getFrameRate() - 确保视频路径是绝对路径，
new FFmpegFrameGrabber("video.mp4")在 classpath 下会找不到——JavaCV 不走 classpath，只认文件系统路径 - 单次抓帧后记得
grabber.flush()或重建实例，重复用一个grabber对象跨多个文件易出错
用 FFmpegFrameRecorder 录屏/转码失败，注意编码器和时间基
录屏黑屏、生成文件无法播放、音频不同步，90% 出在 setVideoCodec() 和 setFrameRate() 不匹配，或没设 setTimestamp()。FFmpeg 要求输入帧的时间戳（PTS）严格递增且基于同一时间基（time base），JavaCV 默认用微秒，但 H.264 编码器常期望毫秒级精度。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 设编码器优先用
avcodec.AV_CODEC_ID_H264，别用字符串"h264"——后者依赖 ffmpeg 查表，容易 fallback 到不支持的软编 - 必须显式调
recorder.setTimestamp(System.nanoTime() / 1000)（单位微秒），否则首帧 PTS=0，第二帧 PTS 还是 0，编码器直接丢帧 - Windows 录屏推荐用
new FFmpegFrameGrabber("gdigrab", "desktop")，别用directshow——后者需额外驱动，兼容性差
JavaCV 版本和 FFmpeg 版本不是越新越好
新版 JavaCV（如 1.5.9+）默认绑 FFmpeg 6.x，但很多企业环境还跑着 CentOS 7，glibc 2.17 不支持 FFmpeg 6 的某些 symbol。反过来，JavaCV 1.4.x 绑 FFmpeg 4.2，虽旧但稳定，尤其适合 Docker 多阶段构建中固定基础镜像的场景。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 生产环境锁定
javacv-platform版本，例如1.5.8，别用1.5.+——小版本升级可能静默切换 native 库 ABI - 查当前 JavaCV 实际加载的 FFmpeg 版本：启动时加 JVM 参数
-Dorg.bytedeco.javacv.logger.level=DEBUG，看日志里Loaded library avcodec from ...ffmpeg-6.0-... - Android 项目慎用 JavaCV，NDK 架构（arm64-v8a / armeabi-v7a）必须和 JavaCV 的
platformclassifier 严格对应，否则运行时报java.lang.UnsatisfiedLinkError: dlopen failed: library "libavutil.so" not found
真正麻烦的从来不是“怎么连上 FFmpeg”，而是帧时间戳对齐、native 内存生命周期、跨平台 native 库分发——这些细节不写进代码注释，下次维护的人一定得重踩一遍。
