video poster 首帧黑屏 6 秒 | iOS 17.2 下为什么不显示

详情页视频宽度 100%,poster 指向 cover.jpg,240KB。iOS 17.2 的 Safari 打开先黑 6 秒,封面根本不出现,控制台一条报错都没有;同一页面安卓 Chrome 120 封面秒出。产品截图发群里,第一判断是图片没上传。

试过给 video 加 background-image 指向同一张图,iOS 上黑框把背景整个盖住,等于没加;试过 preload="none",封面还是黑;试过把 poster 换成 base64 内联,依旧黑。三个方案都失败,说明问题不在图片本身。

抓包才看清:iOS 上 poster 的请求根本没有发出。Safari 对 poster 的加载时机是 video 进入渲染树之后,而且要求响应头是可解码的图片类型。服务器返回的 Content-Type 是 application/octet-stream,原因是 nginx 的 mime.types 里 jpg 那一行被注释掉了,Chrome 宽容照解,Safari 直接放弃。

补上 image/jpeg 映射并 reload,用 curl -I 确认响应头变成 image/jpeg,iOS 上请求发出并返回 200,封面在 0.3 秒内出现。顺手把 poster 从 4:3 重出成 16:9,video 补 object-fit: cover,避免封面被拉伸变形。

还剩首次点击播放时的一帧黑,属于解码器初始化,与封面无关。加 playsinline 和 preload="metadata" 后,从点击到出画 0.4 秒,肉眼基本看不到。

上线一周看日志,iOS 的 poster 请求命中率 100%,关于首屏黑屏的工单从每天 9 条掉到 0 条,这条线就不用再动了。

# /etc/nginx/mime.types 里补回这一行
image/jpeg  jpg jpeg;
image/png   png;
image/webp  webp;

<video src="a.mp4" poster="/cover.jpg"
       playsinline preload="metadata"
       style="object-fit:cover"></video>

您可以还会对下面的文章感兴趣: