iOS平台Swift无法播放Subsonic服务链接音频问题求助

我之前在集成Subsonic和AVPlayer时也碰到过几乎一模一样的问题——直接用带.mp3后缀的URL能正常播放，但调用REST下载接口的链接就不行，咱们一步步来解决：

先修复最常见的URL转义问题 #

你代码里的URL用了&，这是HTML实体转义后的&符号，但iOS的URL(string:)不会自动解析这种转义，导致生成的URL实际是无效的。你需要把所有&替换成普通的&：

var player: AVPlayer!
override func viewDidLoad() {
    super.viewDidLoad()
    // 替换HTML转义的&符号，生成正确的URL
    let correctedUrlString = "http://192.168.1.74:4040/rest/download?u=admin&p=admin&v=1.12.0&c=myapp&id=114&format=mp3"
    guard let url = URL(string: correctedUrlString) else {
        print("生成URL失败，请检查参数格式")
        return
    }
    
    let playerItem = CachingPlayerItem(url: url)
    // 手动指定MIME类型，避免AVPlayer识别错误
    playerItem.mimeType = "audio/mpeg"
    playerItem.delegate = self
    
    player = AVPlayer(playerItem: playerItem)
    // 可以添加播放准备完成的监听，确保音频加载完成后再播放
    NotificationCenter.default.addObserver(self, selector: #selector(onPlayerItemReady), name: .AVPlayerItemNewAccessLogEntry, object: player.currentItem)
}

@objc func onPlayerItemReady() {
    player.play()
}

其他可能的排查方向 #

如果修复URL后还是无法播放，可以试试这几个步骤：

• 检查Subsonic响应头：用curl或者浏览器访问这个REST链接，查看响应的Content-Type是否为audio/mpeg（标准MP3类型）。如果返回的是application/octet-stream这类通用二进制类型，AVPlayer可能无法识别，这时候手动设置playerItem.mimeType就很关键。
• 验证CachingPlayerItem的兼容性：有些第三方缓存播放器类可能没有处理Subsonic的分块传输（Chunked Transfer Encoding）或者Range请求。你可以先试试直接用原生的AVPlayerItem测试，如果原生的能播放，那问题就出在CachingPlayerItem的实现上，需要调整它的缓存逻辑。
• 确认Subsonic API参数有效性：检查id=114对应的音频是否存在，format=mp3是否触发了正确的转码（如果原文件不是MP3的话）。可以在Subsonic的Web界面里测试这个下载链接，确认能正常下载音频文件。

内容的提问来源于stack exchange，提问作者Alec.