Flutter使用flutter_svg渲染SVG异常：仅热重启后正常

结合你描述的症状、控制台报错以及配置信息，问题主要集中在资源路径不匹配、特殊文件名兼容性和Flutter缓存残留这几个核心点，下面是针对性的解决步骤：

1. 修正pubspec.yaml的Asset路径配置 #

从你的pubspec可以看到，部分SVG资源没有添加images/前缀（比如Weo Status.svg、weo-device NotConnected.svg），但代码里是通过images/$image来加载资源的——这就导致首次启动时系统找不到对应Asset，热重启后缓存机制偶然让资源加载成功。

正确配置方式： #

要么给所有资源统一加上images/前缀，要么直接配置整个images目录（更推荐，避免逐个维护）：

flutter:
  uses-material-design: true
  assets:
    # 推荐：直接配置整个images目录，无需逐个添加文件
    - images/
    # 如果保留单个文件配置，确保每个路径都包含images/
    # - images/All Acs.svg
    # - images/weo.svg
    # ... 其他文件统一补全images/前缀

2. 处理文件名中的空格与特殊字符 #

Flutter对含空格、特殊符号的Asset文件名支持不稳定，这也是加载异常的常见诱因。比如你的weo-device NotConnected.svg、All Acs.svg这类文件名，建议：

• 将空格替换为下划线或连字符，比如改为weo_device_notconnected.svg、all_acs.svg
• 同步修改代码中image变量的对应值
• 更新pubspec.yaml里的Asset路径，保持和新文件名完全一致

3. 清理Flutter与构建缓存 #

你提到切换过Flutter通道（从master切回stable），通道切换后的缓存残留很可能导致资源加载异常，执行以下命令彻底清理：

# 清理Flutter全局缓存
flutter clean
# 重新获取依赖包
flutter pub get
# 清除Android构建缓存（可选，针对Android端问题）
cd android && ./gradlew clean && cd ..

4. 验证资源路径与大小写匹配 #

确保SVG文件确实放在项目根目录的images/文件夹下，且文件名大小写完全匹配（Flutter的Asset路径是大小写敏感的，比如Weo Status.svg和weo status.svg会被视为两个不同资源）。

5. 额外排查优化点 #

如果以上步骤无效，可以尝试：

• 升级flutter_svg到最新稳定版本（你当前用的0.15.0版本较旧，后续版本修复了大量加载问题）：

  dependencies:
    flutter_svg: ^2.0.7 # 替换为最新稳定版
  

• 尝试在加载时显式指定缓存策略（强制重新加载资源）：

  Center(
    child: SvgPicture.asset(
      "images/$image",
      width: 55.0,
      height: 55.0,
      cacheColorFilter: false,
    )
  ),
  

按照上述步骤逐一排查，应该能解决你遇到的首次加载失败问题。

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