进阶 docs.invidious.io 2026-10-13 23:01:14 · 33 阅读
第12章 使用 DevTools 诊断视频播放问题
用 DevTools 诊断视频播放问题
为什么要看这个教程?
Invidious,或者更准确地说 Video.JS(视频播放器所用的库),无法为那条著名的错误信息"The media could not be loaded, either because the server or network failed or because the format is not supported."(媒体无法加载,可能是服务器或网络故障,也可能是格式不支持)提供真正的错误原因。
下面教你怎么找到真正的错误并修复它。
前提条件
本教程仅适用于桌面版 Firefox 和 Chromium 内核浏览器(Chrome、Brave、Opera、Vivaldi、Edge 等)。
打开 DevTools 并熟悉 Network 标签页
按键盘上的 F12 键;如果没反应,同时按 Ctrl + Shift + E。
默认会打开"Elements"面板,请点击切换到"Network"标签页。
你应该会看到类似这样的窗口:
此时可能还没列出任何请求,也可能已经有一些进行中的请求,按照第二部分继续排查即可。 排查失败的请求 保持 DevTools 处于打开状态。 在 Chromium 内核浏览器上,把"Status"这一列拖到尽可能宽。
在 Firefox 上,把"Transferred"这一列拖到尽可能宽。
刷新页面(按 F5),如果刷新后视频没有自动播放,就重新加载视频。 Name、Status、Type、Size(或"Status"、"Method"、"File")下方的每一行都代表一个"Web Request"(网络请求)。更多说明见这里。 找到显示为红色的行,对照下面的请求类型、原因和解决办法逐一处理: A)名称为"videoplayback"、状态为 403 或 NS_BINDING_ABORTED 的请求 诊断方法 在 Chromium 内核浏览器上,状态码一目了然,直接看下面的"原因与解决办法"即可。 在 Firefox 上,点击该请求所在的行,在展开的新区域里查看"Status",如果是 403 就看"原因与解决办法",否则继续对照其他请求类型。 原因与解决办法 请阅读专门页面:Videoplayback URLs that returns 403 HTTP errors B)名称为"videoplayback"、"latest_version"或某串随机数字/字母并带有"?local=true"的请求,状态为 ERR_NAME_NOT_RESOLVED、NS_ERROR_UNKNOWN_HOST、CORS failed、NS_ERROR_CONNECTION_REFUSED、ERR_CONNECTION_REFUSED,或任何以 NS_ERROR_CONNECTION 或 ERR_CONNECTION 开头的错误
原因 你的浏览器无法解析外部资源,因为域名/主机名不存在,或者没有服务器在相应端口监听,又或者该端口受到限制。 解决方案 请确保你已严格按照安装指南中的 post install 步骤操作。 可以在 Invidious 的 GitHub issues 中搜索错误信息,寻找可能的解决方案:https://github.com/iv-org/invidious/issues C) 请求状态码为 500 或 400
原因 Invidious 后端返回了错误。 诊断 点击该请求对应的行,切换到 "Preview" 标签页查看错误内容。 如果是 HTML 响应,你可以直接看到错误;如果是 JSON 响应,你可能需要滚动或仔细查找具体错误。 解决方案 记录在 DevTools 中发现的错误,同时检查 Invidious 的日志中是否有相关错误。完成后,在 Invidious 的 issues 中搜索可能的解决方案:https://github.com/iv-org/invidious/issues D) 我看到 "videoplayback" 有红色标记,但我的错误类型不在列表中 诊断 点击该请求对应的行,检查状态码或 Firefox 中的 "Status"。 解决方案 在 Invidious 的 GitHub issues 中搜索错误信息,寻找可能的解决方案:https://github.com/iv-org/invidious/issues 如果确实没有找到解决方案,你可能遇到了未知的 bug。如果是这种情况,请在 https://github.com/iv-org/invidious/issues/new/choose 提交 bug 报告。
务必尽可能包含更多细节。 E) 我看不到任何红色标记 诊断 转到 Console 标签页检查错误。如果你看到类似 "The media could not be loaded, either because the server or network failed or because the format is not supported." 的错误,请查看以下解决方案: 解决方案 如果你使用的是 Microsoft Edge 或非标准版 Firefox 安装,可能缺少某些编解码器:https://github.com/iv-org/invidious/issues/3756 在 Invidious 的 GitHub issues 中搜索错误信息,寻找可能的解决方案:https://github.com/iv-org/invidious/issues 如果确实没有找到解决方案,你可能遇到了未知的 bug。如果是这种情况,请在 https://github.com/iv-org/invidious/issues/new/choose 提交 bug 报告。
此时可能还没列出任何请求,也可能已经有一些进行中的请求,按照第二部分继续排查即可。 排查失败的请求 保持 DevTools 处于打开状态。 在 Chromium 内核浏览器上,把"Status"这一列拖到尽可能宽。
在 Firefox 上,把"Transferred"这一列拖到尽可能宽。
刷新页面(按 F5),如果刷新后视频没有自动播放,就重新加载视频。 Name、Status、Type、Size(或"Status"、"Method"、"File")下方的每一行都代表一个"Web Request"(网络请求)。更多说明见这里。 找到显示为红色的行,对照下面的请求类型、原因和解决办法逐一处理: A)名称为"videoplayback"、状态为 403 或 NS_BINDING_ABORTED 的请求 诊断方法 在 Chromium 内核浏览器上,状态码一目了然,直接看下面的"原因与解决办法"即可。 在 Firefox 上,点击该请求所在的行,在展开的新区域里查看"Status",如果是 403 就看"原因与解决办法",否则继续对照其他请求类型。 原因与解决办法 请阅读专门页面:Videoplayback URLs that returns 403 HTTP errors B)名称为"videoplayback"、"latest_version"或某串随机数字/字母并带有"?local=true"的请求,状态为 ERR_NAME_NOT_RESOLVED、NS_ERROR_UNKNOWN_HOST、CORS failed、NS_ERROR_CONNECTION_REFUSED、ERR_CONNECTION_REFUSED,或任何以 NS_ERROR_CONNECTION 或 ERR_CONNECTION 开头的错误
原因 你的浏览器无法解析外部资源,因为域名/主机名不存在,或者没有服务器在相应端口监听,又或者该端口受到限制。 解决方案 请确保你已严格按照安装指南中的 post install 步骤操作。 可以在 Invidious 的 GitHub issues 中搜索错误信息,寻找可能的解决方案:https://github.com/iv-org/invidious/issues C) 请求状态码为 500 或 400
原因 Invidious 后端返回了错误。 诊断 点击该请求对应的行,切换到 "Preview" 标签页查看错误内容。 如果是 HTML 响应,你可以直接看到错误;如果是 JSON 响应,你可能需要滚动或仔细查找具体错误。 解决方案 记录在 DevTools 中发现的错误,同时检查 Invidious 的日志中是否有相关错误。完成后,在 Invidious 的 issues 中搜索可能的解决方案:https://github.com/iv-org/invidious/issues D) 我看到 "videoplayback" 有红色标记,但我的错误类型不在列表中 诊断 点击该请求对应的行,检查状态码或 Firefox 中的 "Status"。 解决方案 在 Invidious 的 GitHub issues 中搜索错误信息,寻找可能的解决方案:https://github.com/iv-org/invidious/issues 如果确实没有找到解决方案,你可能遇到了未知的 bug。如果是这种情况,请在 https://github.com/iv-org/invidious/issues/new/choose 提交 bug 报告。
务必尽可能包含更多细节。 E) 我看不到任何红色标记 诊断 转到 Console 标签页检查错误。如果你看到类似 "The media could not be loaded, either because the server or network failed or because the format is not supported." 的错误,请查看以下解决方案: 解决方案 如果你使用的是 Microsoft Edge 或非标准版 Firefox 安装,可能缺少某些编解码器:https://github.com/iv-org/invidious/issues/3756 在 Invidious 的 GitHub issues 中搜索错误信息,寻找可能的解决方案:https://github.com/iv-org/invidious/issues 如果确实没有找到解决方案,你可能遇到了未知的 bug。如果是这种情况,请在 https://github.com/iv-org/invidious/issues/new/choose 提交 bug 报告。
请尽可能提供详细的信息。
导出请求记录,以便 Invidious 开发者进一步分析。
发送文件前请注意:
切勿将此文件发送给陌生人。文件包含个人信息及敏感数据。
仅与你信任的人(如 Invidious 开发者)分享。
或者手动编辑文件,移除其中的个人信息。
在基于 Chromium 的浏览器中,使用以下按钮:
在 Firefox 中,操作如下:
高级故障排查
对于基于 Chromium 的浏览器,推荐参考这篇教程,讲解如何使用 Network 选项卡:https://developer.chrome.com/docs/devtools/overview#network
还有一段视频教程:https://youtu.be/t1c5tNPpXjs?t=206
Firefox 有专门的指南:https://firefox-source-docs.mozilla.org/devtools-user/network_monitor/index.html