Shairport-Sync音频输出问题排查与解决方案

问题现象描述

在使用Shairport-Sync作为AirPlay接收端时，用户遇到了音频无法输出的问题。具体表现为：

1. 通过speaker-test工具测试音频设备可以正常工作
2. 当尝试在Shairport-Sync运行时使用speaker-test，会收到"Device or resource busy"错误
3. 音频输出设备配置为"hw:Set"（直接硬件设备访问）
4. 问题仅出现在iOS设备连接时，macOS和iPadOS设备连接正常

系统环境分析

出现问题的系统环境具有以下特点：

• 操作系统：Debian GNU/Linux
• 音频硬件：
  • 板载声卡：Realtec ALC283
  • USB音频设备：C-Media USB Headphone Set
• Shairport-Sync版本：4.3.7-2（支持AirPlay2）
• 音频子系统：ALSA

问题诊断过程

第一步：确认音频设备状态

通过aplay -l命令可以列出所有可用的音频设备。在本案例中，系统识别到了两个音频设备：

1. 板载声卡（HDA Intel PCH）
2. USB音频设备（C-Media USB Headphone Set）

第二步：验证设备访问权限

使用speaker-test工具可以成功播放测试音，说明：

• 音频硬件本身工作正常
• 用户有访问音频设备的权限
• ALSA驱动配置正确

第三步：检查设备占用情况

当Shairport-Sync运行时，speaker-test报告设备忙，这表明：

• Shairport-Sync已经成功打开了音频设备
• 音频设备不支持多路复用（这是ALSA硬件的典型行为）

第四步：分析平台差异

有趣的是，问题表现出平台特异性：

• macOS和iPadOS连接时工作正常
• iOS连接时出现问题

这表明问题可能与iOS设备的AirPlay实现或协商过程有关。

解决方案

经过排查，最终发现：

1. iOS系统更新解决问题：将iOS设备从18.3.2升级到18.4后，问题得到解决。这表明问题可能与iOS系统的AirPlay客户端实现有关。

2. 临时解决方案：在无法立即升级系统的情况下，可以尝试：

   • 重启iOS设备
   • 在Shairport-Sync配置中使用plughw:设备而非hw:设备（增加软件转换层）
   • 调整Shairport-Sync的缓冲区设置

技术要点总结

1. ALSA设备独占性：ALSA硬件设备通常不支持多客户端同时访问，这是设计行为而非缺陷。

2. 平台兼容性：不同平台的AirPlay实现可能存在细微差异，特别是在协议协商阶段。

3. 调试技巧：

   • 使用speaker-test验证音频设备基本功能
   • 通过aplay -l和aplay -L了解设备命名和特性
   • 在Shairport-Sync中使用-v参数增加日志详细程度

4. 配置建议：

   • 对于稳定性要求高的场景，考虑使用plughw:而非hw:设备
   • 定期更新客户端设备系统
   • 在配置变更后，重启相关服务进行验证

最佳实践

1. 分层调试：从硬件层开始逐步向上排查（硬件→驱动→中间件→应用层）

2. 变更管理：记录系统配置变更，便于问题回溯

3. 版本控制：保持Shairport-Sync和客户端设备系统的最新稳定版本

4. 日志分析：合理利用日志级别，在问题发生时收集足够但不过量的调试信息

通过系统化的排查方法和对音频子系统工作原理的理解，可以高效解决Shairport-Sync使用过程中的各类音频输出问题。