Flutter报错：Unable to load asset，资产加载失败求解决方案

问题重现 #

运行Flutter应用时遇到Unable to load asset错误，无法加载指定图片资产。已检查路径拼写、pubspec配置，尝试多种方法仍未解决。

相关代码：

• main.dart的build方法：

Widget build(BuildContext context) {
  return MaterialApp(
    theme: MyAppTheme.lightTheme,
    darkTheme: MyAppTheme.darkTheme,
    themeMode: ThemeMode.system,
    home: SplashScreen(),
  );
}

• SplashScreen的build方法：

Widget build(BuildContext context) {
  return const Scaffold(
    body: Stack(
      children: [
        Positioned(
          child: Image(
            image: AssetImage(iconaCerchioBlu)
          )
        )
      ],
    ),
  );
}

• 资产路径常量定义：

const String iconaCerchioBlu = "/assets/images/cerchioBlu.png";
const String iconaCerchioVerde = "/assets/images/cerchioVerde.png";

pubspec.yaml配置：

flutter:
  uses-material-design: true
  assets:
    - assets/images/

解决思路 #

以下是针对性的排查和解决步骤：

• 修正资产路径开头的斜杠
  Flutter的资产路径不需要以斜杠开头，你定义的iconaCerchioBlu路径多了开头的/，导致路径匹配失败。修改为：

  const String iconaCerchioBlu = "assets/images/cerchioBlu.png";
  

  原因：pubspec中配置的assets/images/是相对于项目根目录的路径，开头加斜杠会让Flutter从系统根目录查找，自然找不到资产。

• 确认pubspec.yaml的缩进规范
  YAML对缩进要求严格，确保assets:下的条目是2个空格缩进（和uses-material-design:对齐），不能使用Tab键缩进，否则配置不会生效。

• 清理缓存并重启服务
  执行以下命令清理缓存，然后重新获取依赖并重启应用：

  flutter clean
  flutter pub get
  

  旧的资产缓存可能导致新配置不生效，这一步能解决大部分缓存相关问题。

• 验证文件名和路径大小写
  在iOS、macOS等平台，Flutter对文件名大小写敏感，确保你的图片文件名cerchioBlu.png和代码中的拼写完全一致，包括大小写。

• 直接硬编码路径测试
  临时将AssetImage的路径改为硬编码形式：

  AssetImage("assets/images/cerchioBlu.png")
  

  如果能正常加载，说明问题出在常量定义上；如果还是报错，再检查pubspec配置和文件实际位置。

• 确认资产文件位置
  确保assets/images/cerchioBlu.png确实存放在项目根目录下的对应文件夹中，而非lib或其他子目录里。

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