微信小程序 video 组件的 poster 必须显式设置 :controls="true"，且 poster 必须为 HTTPS 白名单域名的网络 URL；iOS 本地视频需服务端生成封面；推荐用 v-if 延迟渲染确保 URL 有效。
controls 属性必须显式设为 true
微信小程序端的 video 组件，poster 依赖于控件渲染上下文。即使文档说默认值是 true，但在部分基础库版本（尤其是 2.25.2 以下）或某些安卓厂商定制小程序环境中，不显式声明 :controls="true" 会导致 poster 渲染被跳过。
常见错误写法：
正确写法必须包含：
这不是“可有可无”的配置，而是小程序平台底层对 poster 渲染时机的硬性要求——只有控件初始化完成，封面图才会被触发加载。
poster 必须用网络 URL，且域名需在小程序后台白名单
小程序严格限制资源协议和域名。本地路径（如 /static/cover.jpg）、base64 字符串、file:// 或未备案的 HTTP 地址，在真机上一律失效。
- 必须使用 HTTPS 协议的完整 URL，例如：
https://cdn.example.com/cover.webp - 该域名必须提前添加到小程序「开发管理 → 服务器域名」的
request和downloadFile白名单中 - 即使图片能被浏览器直接访问，若未加白名单，小程序内仍会静默失败，控制台通常不报错，只留黑屏
调试时可在真机上打开开发者工具 → Network 标签页，筛选 cover 类请求，看是否返回 404 或被拦截。
iOS 真机下首帧提取失败导致封面空白
当视频来自本地相册（uni.chooseVideo），iOS 系统不会自动提供缩略图，而 uni-app 的 poster 属性又无法主动读取视频首帧。结果就是：src 是本地临时路径（tmp_*.mp4），poster 却为空或无效，最终显示空白。
可行解法只有两个：
- 上传视频后，服务端生成封面图并返回 URL，再赋值给 poster
- 前端用
canvas+URL.createObjectURL提取首帧（仅 H5 可行，小程序和 App 不支持 video.currentTime 操作本地 blob）
注意：不要尝试在 iOS 上用 @loadedmetadata 后手动截帧——小程序 WebView 不允许跨域/本地视频帧读取，会抛 SecurityError。
v-if 延迟渲染比 v-show 更可靠
poster 加载失败常因组件初始化早于图片资源就绪。用 v-show 仅控制 visibility，组件已挂载，poster 属性可能仍为空；而 v-if 能彻底推迟组件创建，直到 poster URL 确认有效。
示例逻辑：
<video v-if="posterUrl && posterUrl.startsWith('https://')" :src="videoSrc" :poster="posterUrl" :controls="true"></video>
这个判断过滤掉了本地路径、空值、HTTP 协议等高危情况。比单纯依赖 onLoad 或 @canplay 更前置、更可控。
真正容易被忽略的是：poster 不是“静态属性”，它和 src 一样受 Vue 响应式系统约束，但它的加载失败不会触发任何事件，也没有 error 回调——你得靠 URL 格式校验 + 平台规则预判，而不是等它出错再处理。
