Flutter Android应用中SVG文件无法显示的解决求助

在Flutter Android应用中使用SVG文件时出现仅显示空容器的问题，已尝试清理项目、重启Flutter、重新获取依赖等操作，问题仍未解决。以下是相关配置代码及可行的解决办法：

相关配置代码 #

pubspec.yaml 资源配置 #

flutter:
  assets:
    - assets/logo.png
    - assets/welcome_bg.jpg
    - assets/logo-nbg.png
    - assets/create_screen_icon.svg
    - assets/upload_image.svg

承载SVG的Container代码 #

Container(
  margin: EdgeInsets.only(top: 5),
  child: SvgPicture.asset('assets/upload_image.svg',
    height: 100,
    width: 100,)
),

可行解决办法 #

• 确认flutter_svg依赖已正确添加：检查pubspec.yaml中是否包含flutter_svg: ^x.x.x（替换为最新稳定版本），并确保执行过flutter pub get完成依赖安装。未添加该依赖会直接导致无法解析SVG文件。
• 验证SVG文件的兼容性：部分SVG可能包含flutter_svg不支持的特性（如复杂滤镜、非标准语法），可以用简单的SVG文件（如仅包含基础图形的测试文件）替换原有文件，排查是否是文件本身的问题。
• 核对文件路径与名称：确保pubspec.yaml中声明的路径和SvgPicture.asset调用的路径完全一致，注意Android系统对文件路径的大小写敏感，避免拼写错误或大小写不匹配。
• 添加fit属性适配容器：给SvgPicture.asset添加fit: BoxFit.contain参数，强制SVG适配容器尺寸，避免因SVG自身尺寸与容器不匹配导致的空容器问题。
• 深度清理缓存后重建：执行flutter clean命令，手动删除android/app目录下的.build文件夹，再依次执行flutter pub get和flutter run，彻底清除缓存后重新构建项目。
• 检查Android配置要求：确认AndroidManifest.xml无资源加载限制，同时确保项目的minSdkVersion符合flutter_svg的要求（通常需≥21），可在android/app/build.gradle中调整该配置。

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