### [03.03.030 排查视频不显示或无法播放](https://guaqi.com/docs/77551)

**Published:** 2026-09-11T02:23:05

**Author:** 二丿小青年

**Excerpt:** 一、这个功能能做什么 视频故障先区分三种情况：模块完全不显示、显示购买或登录提示、播放器已经出现但无法播放。 …

[03 文章与内容](/docs-archive/1231) / [03.03 视频](/docs-archive/1234)

## 一、这个功能能做什么

视频故障先区分三种情况：模块完全不显示、显示购买或登录提示、播放器已经出现但无法播放。

### 先认识这几个词

-   **前端**：访客实际打开和使用的网站；同一后台可以对应多个前端网址。

## 二、设置后会有什么效果

可以区分模板没有视频模块、用户没有观看权限和视频地址不兼容。购买成功也无法修复已失效的外部视频地址。

## 三、怎么使用

| 现象  | 检查顺序 |
| --- | --- |
| 没有视频模块 | 开关、播放列表、文章模板、发布状态、前端分类范围和语言 |
| 只有登录或购买提示 | 当前身份、整组观看权限、单条免费和需登录选项 |
| 有播放器但加载失败 | 完整媒体地址、原平台站外播放、文件访问及浏览器错误 |
| 免费视频游客仍看不了 | 条目是否要求登录，以及接口是否提供有效地址 |
| 翻译文章只有原语言视频 | 复制保留媒体地址，文字翻译不替换媒体内容 |

### 怎样确认权限问题

用游客、普通登录用户和应当有权限的会员分别检查同一条视频。后台会按权限决定是否返回播放地址，不能只凭后台已有地址判断游客应当能播放。

### 怎样确认地址问题

先直接打开完整地址判断资源是否存在，再看它是否属于项目支持解析的平台。第三方网页地址不能普遍当作媒体文件地址。对不支持的短链，先获取完整视频地址。

不要将浏览器自动播放被阻止理解成购买失败。尝试手动点击播放；嵌入第三方视频本来就不会参与普通视频的自动连播。

## 四、常见问题

### 仍不能解决

提供文章 ID、语言、目标前端、视频条目、访问身份和公开错误。涉及私有媒体地址时，只向支持渠道提供必要且脱敏的信息。



---