Flutter运行报Assertion failed: assetName != null is not true错误求助

错误根因 #

Assertion failed: assetName != null是Flutter框架抛出的参数校验错误，触发原因是调用Image.asset()方法时传入的资源名称参数为空。结合你的业务场景，错误来源于截图生成、加载、添加拖拽逻辑的流程中出现了空值传递。

排查方向 #

• 生成截图的异步逻辑未执行完成时，图片控件已提前渲染，此时绑定的资源路径变量仍为空
• 拖拽逻辑中修改图片资源绑定变量时，误传入空值
• 混淆了图片资源加载方式：运行时生成的本地截图不属于项目预置的assets静态资源，误用Image.asset()加载本地文件路径也会触发参数校验报错

修复方案 #

1. 增加非空判断与占位逻辑 #

加载图片前先校验资源路径/数据是否非空，空值阶段隐藏图片或显示占位符，示例代码如下：

// 定义存储截图路径的可空变量
String? localScreenshotPath;

// 页面图片渲染位置的逻辑
@override
Widget build(BuildContext context) {
  return Column(
    children: [
      // 原有页面内容
      // ...
      // 底部生成的可拖拽图片
      if (localScreenshotPath != null)
        Draggable(
          // 生成的截图是本地文件，用Image.file加载，不要用Image.asset
          child: Image.file(File(localScreenshotPath!)),
          // 拖拽过程中的悬浮预览
          feedback: Opacity(
            opacity: 0.7,
            child: SizedBox(
              width: 120,
              child: Image.file(File(localScreenshotPath!)),
            ),
          ),
        )
    ],
  );
}

2. 异步截图逻辑添加非空校验 #

确保截图生成成功、拿到有效路径后再给变量赋值，示例代码如下：

Future<void> generateScreenshot() async {
  // 原有截图生成逻辑，比如用RenderRepaintBoundary或者第三方截图库
  final String? savedPath = await yourScreenshotGenerateLogic();
  // 仅当拿到有效路径时才更新变量触发重绘
  if (savedPath != null && savedPath.isNotEmpty) {
    setState(() {
      localScreenshotPath = savedPath;
    });
  }
}

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