You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

无法加载资产maher.jpg,物理设备加载资产失败求助

解决Flutter物理设备加载本地资产失败的排查步骤
  • 核对资产路径与配置
    确认maher.jpg的实际存放目录,比如是否在项目根目录的assets文件夹下,同时检查pubspec.yaml中的资产配置是否准确,示例正确配置如下:

    flutter:
      assets:
        - assets/maher.jpg
    

    注意:物理设备(尤其是iOS)对路径大小写严格敏感,必须保证文件名、配置路径和代码引用完全一致,比如不能把maher.jpg写成Maher.jpg。

  • 清理缓存并重新构建
    执行以下命令清理旧缓存并重新构建项目:

    flutter clean
    flutter pub get
    flutter run
    

    如果是iOS设备,还可以打开Xcode,执行Product > Clean Build Folder后再重新运行项目。

  • 检查代码中的资产引用
    确认main.dart里Image组件的asset路径和pubspec配置完全匹配,示例正确引用:

    Image.asset('assets/maher.jpg')
    

    排查是否存在多余斜杠、拼写错误等问题。

  • 验证资产是否被打包
    Android设备可查看app/build/intermediates/assets/debug/目录,确认maher.jpg是否存在;iOS设备可借助第三方工具查看Runner.app/Assets.car,确认图片已被打包进产物。

  • 排查设备权限(非常规情况)
    本地资产加载通常无需特殊权限,但如果是iOS设备,可检查Info.plist是否存在限制资源访问的配置;Android设备则确认AndroidManifest.xml中无异常权限限制。

内容的提问来源于stack exchange,提问作者Abdulmateen Maher

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.27 21:22:03