OwnTone项目Soundbridge M1001设备WAV编码重启问题分析

问题背景

在OwnTone音乐服务器项目中，发现Soundbridge M1001设备在播放WAV编码音频时会出现重启现象。这个问题特别出现在播放列表中的第一首歌曲即将结束、设备开始缓冲下一首歌曲时。经过测试，这个问题仅出现在M1001型号设备上，而M2000等其他型号设备工作正常。

问题排查过程

开发团队通过以下步骤进行了深入排查：

1. 现象复现：确认问题仅在M1001设备上出现，且与歌曲长度相关。短于1分钟的歌曲可以正常播放，而3-4分钟的歌曲会导致设备重启。

2. 版本对比：通过git bisect方法定位到问题首次出现的提交点，发现是在3ee9204这个提交后引入的问题。

3. 文件分析：对比了不同版本生成的WAV文件，发现文件头中的大小估计值发生了变化。旧版本使用较为保守的估计值，而新版本使用了更精确但略低于实际值的估计。

4. 设备差异：注意到M1001与其他型号的主要区别在于它需要将所有音频重采样到48kHz，这可能是导致问题的关键因素。

技术分析

WAV文件头包含两个重要的长度字段：

• 文件总大小(位于字节5-8)
• 数据块大小(位于字节40-44)

OwnTone作为流媒体服务器，在实时转码时无法预先知道最终文件大小，因此需要估算这些值。问题的根源在于：

1. 新版本采用了更精确的估算方法，但结果略低于实际文件大小
2. M1001设备的音频处理流水线(特别是重采样环节)对这种差异特别敏感
3. 当缓冲区切换时，大小不匹配可能导致内存访问越界，触发设备重启

解决方案

经过多次测试，开发团队确定了以下解决方案：

1. 保持文件总大小字段为0(表示未知)
2. 使用精确计算的数据块大小值
3. 这种组合既能保证兼容性，又能提供必要的信息

具体代码修改涉及transcode.c文件中的make_wav_header函数，调整了数据块大小的计算方式。

经验总结

这个案例提供了几个重要的经验教训：

1. 嵌入式音频设备对文件格式的容错能力差异很大
2. 实时转码时的元数据估算需要特别谨慎
3. 全面的设备兼容性测试非常重要
4. 问题可能隐藏在看似无关的修改中(如本例中的ALAC支持改进)

该问题的解决不仅修复了M1001设备的问题，也为OwnTone项目的音频转码处理提供了更健壮的实现方案。