go2rtc项目中YAML多行字符串导致API请求失败的解决方案

在go2rtc项目使用过程中，当配置文件包含特定格式的多行字符串时，会导致PUT /api/streams接口返回400 Bad Request错误。这个问题尤其影响与Frigate集成的用户场景。

问题背景

go2rtc是一个流媒体处理工具，支持通过YAML配置文件定义流媒体源。当YAML配置中包含多行字符串时，特别是使用Python的yaml.dump生成的格式，会导致API请求失败。

典型的问题配置如下：

streams:
  birdseye: exec:/usr/lib/ffmpeg/5.0/bin/ffmpeg -hide_banner -hwaccel vaapi -hwaccel_output_format
    vaapi -hwaccel_device /dev/dri/renderD128 -f rawvideo -pix_fmt yuv420p -video_size
    1280x720 -r 10 -i /tmp/cache/birdseye -c:v h264_vaapi -g 50 -bf 0 -profile:v high
    -level:v 4.1 -sei:v 0 -an -vf format=vaapi|nv12,hwupload -rtsp_transport tcp -f
    rtsp {output}

虽然这种格式在YAML规范中是合法的，但go2rtc的实时YAML解析器无法正确处理这种特殊的多行格式。

技术分析

问题的核心在于YAML的多行字符串表示方式。YAML支持多种多行字符串格式：

1. 块缩进式：每行以缩进开始，如问题中的示例
2. 显式控制式：使用>或|等符号控制换行行为

Python的yaml.dump默认会生成第一种格式，而go2rtc的解析器在处理这种格式时存在缺陷，导致API请求失败。

影响范围

这个问题特别影响使用Frigate监控系统的用户，因为Frigate在启用birdseye视图重流功能时，会自动生成这种格式的go2rtc配置文件。这导致这些用户无法通过Home Assistant官方集成正常使用go2rtc功能。

解决方案

go2rtc项目在1.9.9版本中修复了这个问题。开发者建议用户可以采用以下两种方式之一：

1. 升级go2rtc到1.9.9或更高版本：这是最直接的解决方案
2. 修改YAML格式：手动将配置改为更标准的YAML多行格式，例如：

streams:
  birdseye: >-
    exec:/usr/lib/ffmpeg/5.0/bin/ffmpeg -hide_banner -hwaccel vaapi -hwaccel_output_format
    vaapi -hwaccel_device /dev/dri/renderD128 -f rawvideo -pix_fmt yuv420p -video_size
    1280x720 -r 10 -i /tmp/cache/birdseye -c:v h264_vaapi -g 50 -bf 0 -profile:v high
    -level:v 4.1 -sei:v 0 -an -vf format=vaapi|nv12,hwupload -rtsp_transport tcp -f
    rtsp {output}

最佳实践建议

1. 对于生成YAML配置的工具开发者，建议使用明确的换行控制符号
2. 对于go2rtc用户，保持软件版本更新可以避免类似问题
3. 在调试YAML相关问题时，可以使用在线YAML验证工具检查配置格式

这个问题的解决体现了开源社区响应迅速的特点，从问题报告到修复发布仅用了很短时间，为集成系统的稳定运行提供了保障。