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:20:39
上一篇：易优CMS安装程序的时候提示数据库版本与程序不符怎么办_升级SQL_全新安装_迁移