Coil在Image组件中无法加载视频帧问题求助

数据老陈

2026-9-27

问题排查与解决步骤

检查Coil依赖是否完整
旧版本VideoFrameUriFetcher默认仅支持本地视频帧提取，无法直接加载网络视频。如果你使用Coil 2.x及以上版本，需要额外引入视频处理依赖，版本号要和你项目中主Coil依赖的版本保持一致：
```
dependencies {
    implementation "io.coil-kt:coil-video:2.4.0"
}
```
检查网络权限配置
加载网络资源需要在AndroidManifest.xml中声明网络权限，遗漏该权限会导致网络资源加载无响应：
```
<uses-permission android:name="android.permission.INTERNET" />
```

调整视频帧取帧参数
可以先尝试取第0毫秒的关键帧，避免因视频时长不足、非关键帧无法读取导致的加载失败，同时可添加占位图和错误图快速定位加载状态：

Image(
    painter = rememberImagePainter(
        data = previewURL,
        builder = {
            fetcher(VideoFrameUriFetcher(context))
            videoFrameMillis(0)
            placeholder(R.drawable.ic_placeholder)
            error(R.drawable.ic_load_fail)
        }
    ),
    contentDescription = "video frame",
    modifier = Modifier.size(128.dp)
)

如果你使用Coil 2.x版本更推荐用官方新API写法，无需手动指定Fetcher即可自动识别视频资源：

AsyncImage(
    model = ImageRequest.Builder(context)
        .data(previewURL)
        .videoFrameMillis(0)
        .build(),
    contentDescription = "video frame",
    modifier = Modifier.size(128.dp)
)