我之前也碰到过一模一样的情况，咱们一步步来排查解决：

第一步：先确认GIF文件本身的循环设置 #

这是最容易被忽略的关键！很多时候问题根本不在Flutter代码里，而是GIF文件本身被设置成了只播放一次。你可以用GIMP、Photoshop这类图片工具，或者在线GIF查看器检查它的循环参数：

• 正常无限循环的GIF，循环次数会被设为0
• 如果是1或者其他数字，那它就只会播放对应次数

要是这个原因，把GIF的循环设置改成无限循环就行，之后不管用Image.network还是CachedNetworkImage都能正常循环播放。

第二步：调整Flutter组件的配置（如果GIF本身没问题） #

要是GIF已经是无限循环，但还是只播一次，试试下面的方案：

方案1：优化Image.network的配置 #

有时候缓存会导致动画无法重新启动，你可以尝试禁用缓存或者添加唯一key强制重新加载：

Image.network(
  "你的GIF地址",
  // 禁用缓存，每次都重新加载GIF
  headers: const {"Cache-Control": "no-cache"},
  // 或者加个动态key，比如时间戳，确保每次组件重建都重新播放动画
  key: ValueKey(DateTime.now().millisecondsSinceEpoch),
)

方案2：正确配置CachedNetworkImage #

CachedNetworkImage默认会复用缓存的图片数据，要确保动画循环，可以在imageBuilder里明确处理播放逻辑：

CachedNetworkImage(
  imageUrl: "你的GIF地址",
  imageBuilder: (context, imageProvider) => Image(
    image: imageProvider,
    // 禁用无缝播放，确保动画状态能重置
    gaplessPlayback: false,
  ),
  placeholder: (context, url) => CircularProgressIndicator(),
  errorWidget: (context, url, error) => Icon(Icons.error),
)

方案3：用专门的GIF播放组件（可选） #

如果上面的方法都没效果，可以试试第三方库flutter_gif，它能提供更细致的动画控制：

GifImage(
  image: NetworkImage("你的GIF地址"),
  loop: true, // 强制开启无限循环
  autostart: Autostart.loop,
)

使用前需要在pubspec.yaml里添加依赖：

dependencies:
  flutter_gif: ^1.0.0 # 记得检查最新版本

总结 #

优先检查GIF本身的循环设置，这是绝大多数情况的根源；如果GIF没问题，再调整Flutter组件的缓存或播放配置，必要时用第三方库增强控制。

内容的提问来源于stack exchange，提问作者Arun