YouTube Iframe API加载含私有/已删除视频的播放列表完全失败问题咨询

这是YouTube Iframe API存在的已知未修复漏洞，核心触发逻辑为：API加载播放列表时优先校验前序视频可播放性，首次加载时仅自动跳过非首位的无效视频，二次加载时校验范围扩大，会导致原本可正常加载的列表也触发失败。

以下是可落地的规避方案：

方案1：提前过滤无效视频ID #

• 调用YouTube Data API的Videos接口批量查询待播放ID的状态，提前过滤已删除、私有、地区受限的无效资源，将清洗后的ID列表传给播放器。该接口单次最多支持查询50个ID，可批量处理减少请求次数。

方案2：新增首位占位视频+错误监听兜底 #

• 预先准备一个稳定可播放的公共视频ID作为占位，每次加载播放列表时将占位ID放在列表首位，加载完成后自动切到第二个视频，同时监听播放器错误事件，捕获到无效视频错误时主动跳转下一个，参考实现代码如下：

// 可替换为你确认可稳定播放的视频ID
const STABLE_PLACEHOLDER_ID = "dQw4w9WgXcQ";
let player;

function onYouTubeIframeAPIReady() {
  player = new YT.Player('player', {
    width: '512',
    height: '288',
    playerVars: {
      // 占位ID放在列表最前面
      'playlist': [STABLE_PLACEHOLDER_ID, ...myArray].toString(),
    },
    events: {
      'onReady': handlePlayerReady,
      'onError': handlePlayerError
    }
  });
}

function handlePlayerReady(event) {
  // 加载完成后自动跳过占位视频，播放实际业务视频
  event.target.playVideo();
  event.target.nextVideo();
}

function handlePlayerError(event) {
  // 错误码100/150对应视频无法找到/无权限播放，主动切下一个
  if (event.data === 100 || event.data === 150) {
    event.target.nextVideo();
  }
}

const myArray = ["list", "of", "ids"];

// 切换播放列表时也遵循相同逻辑
function loadNewPlaylist(targetIdList) {
  player.cuePlaylist([STABLE_PLACEHOLDER_ID, ...targetIdList]);
}

方案3：切换列表时重建播放器实例 #

如果业务场景允许，切换播放列表时不要复用现有播放器实例调用cuePlaylist方法，直接销毁原有播放器DOM节点，重新初始化新的播放器实例加载目标列表，可绕开实例内部缓存导致的二次校验异常问题。

如果不需要严格保留视频原始排序，也可以在加载前列表做一次简单遍历，把第一个可正常播放的ID放到列表首位，也能解决首次加载失败的问题。

内容的提问来源于stack exchange，提问作者throwaway124-12