pbootcms后台编辑器上传mp4视频默认黑屏不显示如何解决
PbootCMS后台编辑器上传MP4视频后编辑器里显示黑屏或不显示预览前台可能也不播放。原因和解决。
原因一视频编码不兼容。MP4容器里的视频编码是H.265/HEVC或MPEG-4浏览器（包括编辑器内嵌的浏览器组件）不支持解码显示黑屏。解决1. 用FFmpeg转码H.264+AAC ffmpeg -i input.mp4 -vcodec libx264 -acodec aac -strict -2 output.mp4。2. 用格式工厂、HandBrake转码输出格式MP4视频编码H.264音频AAC。3. 转码后重新上传。
原因二编辑器不支持video标签预览。PbootCMS默认编辑器（KindEditor）对MP4的预览支持不好上传后可能只显示一个占位符或黑屏但前台能正常播放。解决1. 编辑器里黑屏不代表前台不能播先看前台效果。2. 前台正常就不用管编辑器预览。3. 前台也不能播才是真问题按视频无法播放文章排查。
原因三视频文件损坏或上传不完整。1. 上传超时或中断文件不完整。2. 检查服务器上视频文件大小和本地对比。3. 重新上传大文件用FTP上传。4. 本地播放器测试视频是否正常。
原因四上传大小限制。视频超过PHP upload_max_filesize或post_max_size上传失败编辑器显示黑屏或错误。解决1. 宝塔-PHP-配置修改upload_max_filesize=100M post_max_size=100M。2. Nginx client_max_body_size 100m。3. PbootCMS后台上传配置附件大小改大。4. 重启PHP和Nginx。5. 大视频（>50MB）建议FTP上传或第三方平台。
原因五视频路径错误。编辑器插入视频时路径不对视频加载404显示黑屏。解决1. F12-Network看视频请求状态404就是路径错。2. 编辑器源码模式看video的src检查路径。3. 用绝对路径/src="/upload/video/xxx.mp4"或完整URL。4. PbootCMS上传目录检查确认文件存在。
原因六MIME类型未配置。Nginx没配置.mp4的MIME类型浏览器不识别不播放。解决1. 直接访问视频URL浏览器下载而不是播放说明MIME问题。2. /www/server/nginx/conf/mime.types里加video/mp4 mp4;（默认有）。3. 或server块加types { video/mp4 mp4; }。4. nginx -s reload。
原因七poster封面图没设。视频第一帧是黑屏（视频开头黑场）没设poster就显示黑屏。解决1. 视频标签加poster属性
原因八编辑器HTML过滤。PbootCMS编辑器的XSS过滤清理了video或source标签保存后标签没了显示空白。解决1. 检查PbootCMS过滤配置允许video、source、track标签。2. 升级PbootCMS最新版修复过滤bug。3. 或用第三方平台嵌入（iframe）iframe通常不被过滤。
原因九浏览器兼容。编辑器用的浏览器内核旧不支持某些MP4编码。解决1. 用Chrome最新版。2. 转码H.264基线（Baseline）profile兼容旧浏览器。3. 提供WebM格式备选（
解决步骤。1. 先看前台能不能播能播→编辑器预览问题不用管不能播→继续。2. 直接访问视频URL能播→标签/路径问题不能播→编码/MIME/文件问题。3. F12看Network和Console错误。4. 转码H.264+AAC。5. 检查上传大小限制。6. 手动写video标签加poster。7. 检查MIME类型。
编辑器插入视频的正确方式。1. 上传视频到/upload/video/（FTP或后台）。2. 编辑器点"插入视频"按钮填视频URL。3. 或切换源码模式手动写： ```html ``` 4. 手动写标签最可靠不依赖编辑器的视频插件。5. 保存前台测试。
大视频替代方案。1. 上传到腾讯视频/优酷/B站用iframe嵌入代码编辑器粘贴。2. 不占服务器空间和带宽播放流畅编辑器里显示iframe预览（可能也是空白但前台正常）。3. 推荐用于产品演示、企业宣传等较长视频。
PbootCMS编辑器MP4黑屏先区分是编辑器预览问题还是真不能播。前台能播就不用管编辑器。真不能播按"编码→大小→路径→MIME→标签"排查转码H.264+手动video标签+poster封面基本解决。
更新时间：2026-08-26 17:48:15