PbootCMS视频播放失败排查实录：从编码转换到播放器配置的完整方案
PbootCMS插入MP4后黑屏、只有声音没画面、提示不支持格式，这些都是视频播放问题。下面是完整的排查和解决实录。
案例一，黑屏只有声音。视频编码是H.265，浏览器不支持视频解码，只解码了音频（AAC）。解决：用HandBrake转码。打开HandBrake，拖入视频，Preset选"Fast 720p30"，Format选MP4，Video标签Encoder选H.264(x264)，Audio标签Codec选AAC，点Start Encode。转完上传，视频正常播放。
案例二，提示"不支持此视频格式"。视频是WMV或AVI格式，被改名成MP4，实际编码不是H.264。解决：看视频真实编码，用MediaInfo工具查看编码格式。必须是H.264+AAC的MP4才兼容。重新用格式工厂转成正确格式。不要直接改文件后缀，编码不会变。
案例三，视频上传后404。文件太大超过PHP上传限制，上传失败。解决：宝塔PHP设置里upload_max_filesize改100M，post_max_size改100M，max_execution_time改300。PbootCMS后台上传配置里附件大小改100M。重启PHP。大视频建议用FTP上传到/upload目录，然后在编辑器里手动填视频URL，不走后台上传。
案例四，视频能播放但没有控制条。video标签缺少controls属性。解决：编辑器里点"源码"，找到video标签，加上controls属性：。也可以加style="max-width:100%;height:auto;"适配移动端。保存后前台有播放按钮和进度条。
案例五，PC能播手机不能播。视频编码是H.264 High Profile Level 5.1，部分手机硬解不支持。解决：转码时Profile选Main或Baseline，Level选3.1或4.0。HandBrake里Video标签-H.264 Profile选Main，Level选4.0。分辨率不超过1280x720，手机兼容性好。
案例六，视频加载慢一直缓冲。文件太大或服务器带宽不够。解决：压缩视频，720p CRF28，文件控制在30MB以内。用CDN加速视频，或放对象存储。视频加preload="metadata"，只加载元数据不预加载整个视频，用户点播放才加载。加poster封面图，加载前显示图片。
案例七，微信里播放自动全屏。iOS微信里video标签默认全屏播放。解决：加playsinline和webkit-playsinline属性：。这样在微信里内嵌播放不全屏。安卓微信一般没问题。
案例八，HTTPS网站视频是HTTP被拦截。混合内容，浏览器阻止HTTP视频在HTTPS页面加载。解决：视频URL改成HTTPS，或视频文件也放HTTPS域名下。PbootCMS后台配置里网站地址用HTTPS，上传的视频URL自动是HTTPS。
播放器升级方案。自带video标签功能简单，需要弹幕、字幕、倍速的话用ckplayer。下载ckplayer，放到网站目录，模板里引入ckplayer.js，内容里用
，JS初始化：var player=new ckplayer({container:'#player',video:'视频URL',poster:'封面URL'});。功能强大，兼容好。预防建议。上传视频前统一转码成H.264+AAC MP4，720p，文件<50MB。建立视频转码标准，所有上传视频按标准处理。后台限制只允许mp4格式，避免用户上传不兼容格式。大视频用第三方视频平台（优酷、腾讯视频）嵌入，不占自己服务器带宽。
更新时间：2026-08-26 17:49:45
上一篇：宝塔面板怎么登录终端_常用命令_服务管理_日志查看_文件操作