排查前先准备
先找到出问题的文章,在编辑页「<瓜奇>文章功能 → 音频」或「画廊」中核对设置,再打开访客实际使用的网站页面检查效果。
准备一个没有整组播放或观看权限的普通账号,并退出登录检查游客看到的结果。只用已经获得整组权限的账号,无法判断免费范围是否正确。
页面上没有音频或画廊
- 确认打开的是正确文章和语言版本,文章已发布,当前网站能够访问。
- 检查「是否开启音频」或「是否开启画廊」是否开启。
- 检查列表中是否已经添加内容。音频需要实际播放地址;画廊需要在图片组内部选好图片。
- 检查文章详情页模板是否配置了对应的音频或画廊模块。
- 保存设置后重新打开文章详情页,确认模块和条目是否出现。
列表页采用什么展示样式,不能代替详情页中的媒体模块配置。
本应受限的内容全部可用
先检查音频的「播放权限」或画廊的「观看权限」。代码会逐条判断适用规则,只要其中一条允许访问,就会开放整组;并不是要求用户同时满足所有规则。
检查是否有免费放行当前用户组的规则,也要确认测试账号是否已经获得整组权限。整组权限允许访问时,音频的单条免费登录条件和画廊的免费图片序号都不会再次缩小范围。
修改后,使用没有整组权限的账号重新检查,并单独验证游客看到的结果。
设置了免费,却仍然不能用
音频
检查对应条目的「是否免费收听此音频」是否开启。如果勾选了「游客不可收听(需登录)」,请登录后再试。免费开关开放的是整条音频,时长字段不能用来设置试听秒数。
画廊
检查「免费查看哪些图片」中的序号和实际图片顺序。当前位置从 0 开始,0,1 才对应前两张;后台示例中的 1,2 实际对应第二、第三张。
图片重排后,原来的免费序号会对应到新位置上的图片,需要重新核对。
两种媒体的免费入口都受站点资源访问限制影响。如果账号本身不能访问资源,仅开启免费也不能解除这项限制。
模块出现了,但音频或图片加载失败
- 确认当前账号应当有权访问这条音频或这张图片。
- 音频检查「完整的音频链接」,不要把封面地址或时长当成播放地址。没有播放权限时,接口会隐藏实际音频地址。
- 画廊检查媒体库中的原图是否仍存在。没有观看权限时,页面可能使用替代图,这不等于原图已经损坏。
- 在出现问题的浏览器中检查原媒体能否加载,确认文件没有删除、移动或失效。
其他语言版本异常
直接打开出问题的语言版本,逐项核对开关、列表、权限和媒体地址,不要只检查原文。音频名称或画廊名称的语言正确,也不代表实际媒体已经换成对应语言。
如果仍需反馈问题,请记录文章 ID、页面地址、语言、访问账号身份、音频条目或图片组的位置、图片位置,以及完整提示。这样才能区分是内容设置、权限还是文件加载问题。