使用image库加载图片失败，报错Unable to load image with image library

你的代码核心错误是直接把图片路径字符串传给了需要字节数据的函数，导致无法正确解码图片。下面是具体的问题分析和修正方案：

问题根源 #

你传入setImageBytes的coverData是字符串'images/map3a.png'，但函数里的imageBytes.buffer.asUint8List()会把字符串的编码字节当成图片字节处理，自然无法解码出有效图片，最终mapImage为null，后续访问mapImage!.height就会触发空指针错误。

修正方案 #

根据图片的存储位置（assets资源/本地文件系统），分别采用对应的读取方式：

情况1：加载Flutter Assets中的图片 #

1. 先在pubspec.yaml中正确配置assets路径：

flutter:
  assets:
    - images/map3a.png

2. 使用异步方式读取并解码图片，避免同步初始化的空指针问题：

import 'package:flutter/services.dart' show rootBundle;
import 'package:image/image.dart' as img;

class ImageLoaderWidget extends StatefulWidget {
  @override
  State<ImageLoaderWidget> createState() => _ImageLoaderWidgetState();
}

class _ImageLoaderWidgetState extends State<ImageLoaderWidget> {
  img.Image? mapImage;
  int? rows;
  int? columns;

  @override
  void initState() {
    super.initState();
    _loadAssetImage();
  }

  Future<void> _loadAssetImage() async {
    // 读取assets中的图片字节
    final byteData = await rootBundle.load('images/map3a.png');
    final imageBytes = byteData.buffer.asUint8List();
    
    // 解码图片
    mapImage = img.decodeImage(imageBytes);
    
    if (mapImage != null) {
      setState(() {
        rows = 2 + mapImage!.height;
        columns = 2 + mapImage!.width;
      });
    } else {
      print('图片解码失败，请检查路径或文件格式');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Center(
      child: mapImage == null
          ? const CircularProgressIndicator()
          : Text('rows: $rows, columns: $columns'),
    );
  }
}

情况2：加载本地文件系统中的图片 #

如果图片在设备存储中，使用File类读取字节：

import 'dart:io';
import 'package:image/image.dart' as img;

// 在异步函数中执行读取逻辑
Future<void> _loadLocalImage() async {
  final file = File('/your/local/image/path/map3a.png');
  if (await file.exists()) {
    final imageBytes = await file.readAsBytes();
    mapImage = img.decodeImage(imageBytes);
    
    if (mapImage != null) {
      rows = 2 + mapImage!.height;
      columns = 2 + mapImage!.width;
      // 更新UI或执行后续逻辑
    }
  } else {
    print('文件不存在，请检查路径');
  }
}

注意事项 #

• 确保图片格式为image库支持的类型（PNG、JPG等），特殊格式可使用对应解码函数（如img.decodePng、img.decodeJpg）
• 本地文件读取需要申请存储权限（Android/iOS需在配置文件中声明权限）
• 所有文件读取操作都是异步的，必须等待操作完成后再访问图片属性，避免空指针

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