3、GStreamer 工具链：gst-launch-1.0命令行、gst-inspect-1.0、gst-discoverer-1.0、gst-validate-1.0的使用与调试技巧

说实话，很多刚接触 GStreamer 的朋友，上来就想着写 C 代码。我当年也这样，结果被管道搞到崩溃。后来才发现，GStreamer 自带的这几个命令行工具，才是真正的「调试神器」。你想想看，连管道都跑不通，写再多代码也是白搭。

这一章，我就带你把这四个工具摸透。它们分别是：gst-launch-1.0（管道搭建器）、gst-inspect-1.0（元件说明书）、gst-discoverer-1.0（媒体分析仪）、gst-validate-1.0（管道质检员）。

3.1 gst-launch-1.0：快速搭建管道原型

这是我最常用的工具，没有之一。它的作用就是：用一行命令，把元件串起来跑通。

基本语法很简单：

gst-launch-1.0 [选项] 元件1 ! 元件2 ! 元件3 ...

这里的 ! 就是管道符号，表示数据从左流到右。举个例子：

gst-launch-1.0 videotestsrc ! autovideosink

这条命令会弹出一个窗口，显示测试视频。嗯，就这么简单。

常用的调试选项有这些：

选项	作用	我什么时候用
-v	打印详细日志	想看数据流经过每个元件时的状态
--gst-debug=*:5	设置调试级别（0-9）	管道跑不通时，开到5以上看细节
-e	优雅退出	按 Ctrl+C 时发送 EOS 事件
--gst-plugin-path=	指定插件路径	调试自己写的插件时必用

举个例子，调试一个网络流：

gst-launch-1.0 -v rtspsrc location=rtsp://192.168.1.100:554/stream ! rtph264depay ! avdec_h264 ! autovideosink

加上 -v 后，你会看到每个元件接收了多少 buffer，有没有丢包。我曾经用这个命令排查过一个 RTSP 流卡顿的问题，发现是 rtph264depay 的缓冲区太小了。

3.2 gst-inspect-1.0：元件的「说明书」

你拿到一个新元件，不知道怎么用？别急着翻文档，先跑一下 gst-inspect-1.0。

基本用法：

gst-inspect-1.0 [元件名]

比如我想看 rtspsrc 有哪些参数：

gst-inspect-1.0 rtspsrc

输出会告诉你：

• 这个元件是做什么的（长描述）
• 它有哪些 pad（输入/输出接口）
• 每个 pad 支持什么格式（caps）
• 所有可配置的属性（properties）
• 信号（signals）和动作（actions）

举个例子，我查 videotestsrc 的输出格式：

gst-inspect-1.0 videotestsrc | grep -A 10 "Pad Templates"

输出会显示：

Pad Templates:
  SRC template: 'src'
    Availability: Always
    Capabilities:
      video/x-raw
                 format: { I420, YV12, YUY2, ... }
                  width: [ 1, 2147483647 ]
                 height: [ 1, 2147483647 ]
              framerate: [ 0/1, 2147483647/1 ]

看到没？它输出的是 video/x-raw，格式是 I420、YV12 这些。如果你后面接的元件只吃 video/x-h264，那肯定报错。

3.3 gst-discoverer-1.0：摸清媒体文件的底细

这个工具，说白了就是「媒体文件分析器」。你给它一个文件或网络流地址，它把里面的信息全扒出来。

用法：

gst-discoverer-1.0 [文件路径或URL]

比如分析一个 MP4 文件：

gst-discoverer-1.0 test.mp4

输出会包含：

• 容器格式（MP4、MKV、AVI 等）
• 视频编码（H.264、H.265、VP9 等）
• 音频编码（AAC、MP3、Opus 等）
• 分辨率、帧率、码率
• 时长、关键帧间隔
• 是否有字幕流

我经常用它来排查「为什么这个视频播不了」的问题。比如：

gst-discoverer-1.0 rtsp://192.168.1.100:554/stream

如果输出显示 video/x-h264 的 profile 是 high-4:4:4，而你的解码器只支持 baseline，那肯定播不了。

3.4 gst-validate-1.0：管道的「自动测试员」

这个工具可能很多人没用过，但它真的很强大。它能自动检测管道运行时的各种问题，比如：

• buffer 泄漏
• 状态转换异常
• 事件处理错误
• 时钟同步问题

基本用法：

gst-validate-1.0 [管道描述]

比如：

gst-validate-1.0 videotestsrc ! autovideosink

它会自动运行管道，并在发现问题时打印警告。你还可以加上 --check 参数来指定检查哪些项目：

gst-validate-1.0 --check=leaks,buffers videotestsrc ! fakesink

这会专门检查 buffer 泄漏问题。

举个例子，我曾经写了一个 RTMP 推流管道，跑起来画面正常，但运行几个小时后会崩溃。用 gst-validate-1.0 一跑，发现是 flvmux 在收到 EOS 事件后没有正确清理内部 buffer，导致内存泄漏。

3.5 四个工具的配合使用技巧

在实际工作中，我很少单独用某一个工具。它们四个是「组合拳」：

1. 先用 gst-discoverer-1.0 分析目标媒体，搞清楚它是什么格式、什么编码。
2. 再用 gst-inspect-1.0 查每个元件的参数，确认它们能处理这些格式。
3. 然后用 gst-launch-1.0 搭管道原型，加上 -v 和调试日志跑通。
4. 最后用 gst-validate-1.0 做压力测试，确保管道稳定。

这套流程走下来，99% 的问题都能在写代码之前解决。剩下的 1%，嗯，那就要看你的代码功底了。