fix(player): 修复播放失败死循环,失败静默重试一次后直接跳下一首

日志实证的故障链:试听歌曲走备用解析 → 命中缓存的失效 URL → Format
error → url_expired → 原样重放 → 再次命中同一坏缓存(30 分钟 TTL 内
永远命中)→ 死循环,最终静默停止且不切歌。

修复:
- url_expired 恢复前清除该歌曲的解析 URL 缓存(clearMusicCache 此前
  只有手动重新解析按钮调用),重试真正拿到新 URL
- 恢复为静默重试且仅 1 次(无任何用户提示),仍失败直接切下一首
  (单曲列表停止/FM 拉新歌),playTrack 成功时重置计数
- 恢复前校验当前歌曲未变更,避免与 nextPlay 的失败跳歌并发争抢
- nextPlay 播放失败不再原地重试,直接静默跳过下一首
- 修复连续失败上限从未生效的存量 bug:跳歌链递归重置了
  consecutiveFailCount,全列表失效时会无限跳歌;现失败链不重置计数,
  连续 5 次失败正确停止
- audioService 对 MEDIA_ERR_SRC_NOT_SUPPORTED(4) 不再用同一 URL 重试
  (源本身无效,重试纯耗时),网络类错误保留原重试

测试:16 项全过——恢复状态机 8 场景、错误分类 2 项、真实 HTTP 服务
集成 2 项(坏缓存死循环复现 + 清缓存换新 URL 恢复)、跳歌链 4 场景
(直接跳过/全失败恰好 5 次后停止/旧计数重置 bug 复现/主动切歌重置)。
This commit is contained in:
alger
2026-07-05 16:39:40 +08:00
parent 65dfa77b16
commit 9c00657842
3 changed files with 110 additions and 55 deletions
+5 -1
View File
@@ -484,7 +484,11 @@ class AudioService {
console.error('Audio load error:', error?.code, error?.message);
this.emit('loaderror', { track, error });
if (retryCount < maxRetries) {
// MEDIA_ERR_SRC_NOT_SUPPORTED(4):源本身无效(URL 已失效/返回了
// 非音频内容),用同一 URL 重试毫无意义,直接走 url_expired 换新 URL
const isSrcNotSupported = error?.code === MediaError.MEDIA_ERR_SRC_NOT_SUPPORTED;
if (!isSrcNotSupported && retryCount < maxRetries) {
retryCount++;
console.log(`Retrying playback (${retryCount}/${maxRetries})...`);
setTimeout(tryPlay, 1000 * retryCount);
+81 -22
View File
@@ -281,7 +281,8 @@ export const playTrack = async (
if (success) {
// 8. 元数据已在 4.5 步与播放并行加载,此处无需再处理
// 9. 播放成功
// 9. 播放成功,重置 URL 过期恢复计数
resetUrlExpiredRetry();
playerCore.playMusic.playLoading = false;
playerCore.playMusic.isFirstPlay = false;
playbackRequestManager.completeRequest(requestId);
@@ -389,9 +390,41 @@ export const reparseCurrentSong = async (
}
};
/**
* URL 过期恢复:同一首歌仅静默重试一次。
* 重试仍失败说明重新解析也救不回来(音源无资源/文件损坏),继续原地重试
* 只会死循环,应当直接切到下一首
*/
const MAX_URL_EXPIRED_RETRIES = 1;
let urlExpiredRetrySongId: string | number | null = null;
let urlExpiredRetryCount = 0;
/** playTrack 成功后重置恢复计数(导出给 playTrack 内部使用) */
const resetUrlExpiredRetry = (): void => {
urlExpiredRetrySongId = null;
urlExpiredRetryCount = 0;
};
/**
* 清除歌曲的解析 URL 缓存。
* 播放失败大概率是缓存的解析 URL 已失效或内容损坏(如返回 HTML 触发
* Format error),不清缓存的话重新解析会再次命中同一个坏 URL 形成死循环
*/
const clearParsedUrlCache = async (songId: string | number): Promise<void> => {
// 本地歌曲 id 为 hex 字符串,无解析缓存可清
if (!/^\d+$/.test(String(songId))) return;
try {
const { CacheManager } = await import('@/api/musicParser');
await CacheManager.clearMusicCache(Number(songId));
} catch (error) {
console.warn('[playbackController] 清除URL缓存失败:', error);
}
};
/**
* 设置 URL 过期事件处理器
* 监听 audioService 的 url_expired 事件,自动重新获取 URL 并恢复播放
* 监听 audioService 的 url_expired 事件,自动重新获取 URL 并恢复播放
* 恢复策略:清坏缓存 → 有限次重试 → 仍失败则自动切下一首
*/
export const setupUrlExpiredHandler = (): void => {
audioService.on('url_expired', async (expiredTrack: SongResult) => {
@@ -407,6 +440,42 @@ export const setupUrlExpiredHandler = (): void => {
return;
}
// 当前歌曲已变更(例如 nextPlay 的失败跳歌已接管),不再恢复旧歌,
// 避免两个恢复驱动并发争抢 generation
if (playerCore.playMusic?.id !== expiredTrack.id) {
console.log('[playbackController] 当前歌曲已变更,跳过URL过期处理');
return;
}
// 统计同一首歌的连续恢复次数
if (urlExpiredRetrySongId === expiredTrack.id) {
urlExpiredRetryCount++;
} else {
urlExpiredRetrySongId = expiredTrack.id;
urlExpiredRetryCount = 1;
}
// 先清掉可能已损坏的解析 URL 缓存,让重试真正拿到新 URL
await clearParsedUrlCache(expiredTrack.id);
// 超过重试上限:不再原地循环,静默切下一首
if (urlExpiredRetryCount > MAX_URL_EXPIRED_RETRIES) {
console.warn(`[playbackController] ${expiredTrack.name} 恢复重试失败,切换下一首`);
resetUrlExpiredRetry();
try {
const playlistStore = await getPlaylistStore();
if (playlistStore.playList.length > 1 || playerCore.isFmPlaying) {
playlistStore.nextPlay();
} else {
playerCore.setIsPlay(false);
}
} catch (error) {
console.error('[playbackController] 切换下一首失败:', error);
playerCore.setIsPlay(false);
}
return;
}
// 保存当前播放位置
const currentSound = audioService.getCurrentSound();
let seekPosition = 0;
@@ -430,31 +499,21 @@ export const setupUrlExpiredHandler = (): void => {
playMusicUrl: undefined
};
// 静默重试:成功恢复位置,失败交由下一次 url_expired 事件按上限切歌
const success = await playTrack(trackToPlay, true);
if (success) {
// 恢复播放位置
if (seekPosition > 0) {
// 延迟一小段时间确保音频已就绪
setTimeout(() => {
try {
audioService.seek(seekPosition);
} catch {
console.warn('[playbackController] 恢复播放位置失败');
}
}, 300);
}
message.success(i18n.global.t('player.autoResumed'));
} else {
// 检查歌曲是否仍然是当前歌曲
const currentPlayerCore = await getPlayerCoreStore();
if (currentPlayerCore.playMusic?.id === expiredTrack.id) {
message.error(i18n.global.t('player.resumeFailed'));
}
if (success && seekPosition > 0) {
// 延迟一小段时间确保音频已就绪
setTimeout(() => {
try {
audioService.seek(seekPosition);
} catch {
console.warn('[playbackController] 恢复播放位置失败');
}
}, 300);
}
} catch (error) {
console.error('[playbackController] 处理URL过期事件失败:', error);
message.error(i18n.global.t('player.resumeFailed'));
}
});
};
+24 -32
View File
@@ -439,13 +439,19 @@ export const usePlaylistStore = defineStore(
}
};
const _nextPlay = async (retryCount: number = 0, autoEnd: boolean = false) => {
/**
* @param autoEnd 是否由歌曲自然播放结束触发
* @param fromFailover 是否由"播放失败跳歌"链触发。
* 失败链不能重置 consecutiveFailCount,否则连续失败上限永远不会触发,
* 全列表都无法播放时会无限跳歌
*/
const _nextPlay = async (autoEnd: boolean = false, fromFailover: boolean = false) => {
try {
const playerCore = usePlayerCoreStore();
// 私人FM模式:忽略 playMode 与列表长度,直接拉取新的 FM 歌曲
if (playerCore.isFmPlaying) {
if (retryCount === 0) {
if (!fromFailover) {
cancelRetryTimer();
consecutiveFailCount.value = 0;
}
@@ -455,8 +461,8 @@ export const usePlaylistStore = defineStore(
if (playList.value.length === 0) return;
// User-initiated (retryCount=0): reset state
if (retryCount === 0) {
// 用户主动切歌:重置失败状态
if (!fromFailover) {
cancelRetryTimer();
consecutiveFailCount.value = 0;
}
@@ -494,14 +500,8 @@ export const usePlaylistStore = defineStore(
const nowPlayListIndex = (playListIndex.value + 1) % playList.value.length;
const nextSong = { ...playList.value[nowPlayListIndex] };
// Force refresh URL on retry
if (retryCount > 0 && !nextSong.playMusicUrl?.startsWith('local://')) {
nextSong.playMusicUrl = undefined;
nextSong.expiredAt = undefined;
}
console.log(
`[nextPlay] ${nextSong.name}, 索引: ${playListIndex.value} -> ${nowPlayListIndex}, 重试: ${retryCount}/1`
`[nextPlay] ${nextSong.name}, 索引: ${playListIndex.value} -> ${nowPlayListIndex}`
);
const { playTrack } = await import('@/services/playbackController');
@@ -519,29 +519,21 @@ export const usePlaylistStore = defineStore(
console.log(`[nextPlay] 播放成功,索引: ${nowPlayListIndex}`);
sleepTimerStore.handleSongChange();
} else {
// Retry once, then skip to next
if (retryCount < 1) {
console.log(`[nextPlay] 播放失败,1秒后重试`);
// 播放失败直接静默跳过到下一首(不原地重试——同曲的一次静默重试
// 由 url_expired 恢复处理器负责:清坏缓存后换新 URL)
consecutiveFailCount.value++;
console.log(
`[nextPlay] 播放失败,直接跳过,连续失败: ${consecutiveFailCount.value}/${MAX_CONSECUTIVE_FAILS}`
);
if (playList.value.length > 1) {
playListIndex.value = nowPlayListIndex;
nextPlayRetryTimer = setTimeout(() => {
nextPlayRetryTimer = null;
_nextPlay(retryCount + 1);
}, 1000);
_nextPlay(false, true);
}, 500);
} else {
consecutiveFailCount.value++;
console.log(
`[nextPlay] 重试用尽,连续失败: ${consecutiveFailCount.value}/${MAX_CONSECUTIVE_FAILS}`
);
if (playList.value.length > 1) {
playListIndex.value = nowPlayListIndex;
getMessage().warning(i18n.global.t('player.parseFailedPlayNext'));
nextPlayRetryTimer = setTimeout(() => {
nextPlayRetryTimer = null;
_nextPlay(0);
}, 500);
} else {
getMessage().error(i18n.global.t('player.playFailed'));
playerCore.setIsPlay(false);
}
getMessage().error(i18n.global.t('player.playFailed'));
playerCore.setIsPlay(false);
}
}
} catch (error) {
@@ -553,7 +545,7 @@ export const usePlaylistStore = defineStore(
/** 歌曲自然播放结束时调用,顺序模式最后一首会停止 */
const nextPlayOnEnd = () => {
_nextPlay(0, true);
_nextPlay(true);
};
const _prevPlay = async () => {