MPMusicPlayerControllerMutableQueue插入Apple Music歌曲非队首无响应求助

我之前在使用MusicKit的队列事务API时也碰到过几乎一模一样的问题，你的代码逻辑方向是对的，但细节上可能踩了两个容易忽略的坑，导致插入非头部时没效果。

问题分析 #

你当前的代码中，当afterItem不为nil时队列无变化且无错误返回，大概率是这两个原因之一：

1. insert(after:)方法对队列item的引用识别存在隐性问题：虽然你找到了对应的afterItem，但事务内的可变队列可能无法正确关联这个item的位置，导致插入操作静默失败。
2. afterItem的匹配逻辑可能存在不易察觉的错误：比如playbackStoreID的大小写差异（理论上不会，但实际测试中偶尔会遇到），或者队列item的playbackStoreID和你传入的predecessorId格式不一致。

修正方案 #

推荐改用通过索引插入的方式替代insert(after:)，这种方式更可靠，也更容易排查问题。下面是调整后的代码：

let musicPlayerController = MPMusicPlayerController.applicationQueuePlayer
musicPlayerController.perform(queueTransaction: { queue in
    // 1. 先找到目标item及其在队列中的索引
    guard let afterItem = queue.items.first(where: { $0.playbackStoreID == predecessorId }),
          let targetIndex = queue.items.firstIndex(of: afterItem) else {
        // 如果找不到目标item，默认插入到头部
        let descriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [newItemId])
        queue.insert(descriptor, at: 0)
        return
    }
    
    // 2. 插入到目标item的下一个位置
    let descriptor = MPMusicPlayerStoreQueueDescriptor(storeIDs: [newItemId])
    queue.insert(descriptor, at: targetIndex + 1)
}) { (updatedQueue, error) in
    if let error = error {
        print("队列更新失败：\(error.localizedDescription)")
    } else {
        print("队列已更新，当前歌曲数：\(updatedQueue?.items.count ?? 0)")
    }
}

额外注意事项 #

• 确保musicPlayerController是全局实例：如果它是局部变量，可能会被提前释放，导致事务操作无响应。
• 插入前可以打印调试信息：比如输出afterItem?.playbackStoreID和predecessorId，确认两者完全匹配；输出targetIndex确认索引正确。
• 如果插入的歌曲已经在队列中，MusicKit会自动处理重复（不会重复添加），所以不需要额外去重。

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