Flutter使用Retrofit返回图片时遇‘void类型值无法使用’错误求助

错误根源 #

1. getData()设计错误：你让它返回Future<void>，且内部直接调用runApp()，完全违背了Flutter的Widget构建逻辑——StatelessWidget的build方法才是负责返回渲染内容的入口，异步函数不该直接重启应用。
2. FutureBuilder使用错误：泛型指定为void后，snapshot.data是无值的void类型，你试图将其传给Text组件，自然触发"This expression has a type of 'void' so its value can't be used."错误，且你实际需要的是显示图片而非文本。

修正后的代码 #

1. 调整getData()，让它返回图片字节数据

Future<Uint8List> getData() async {
  final dio = Dio();
  final client = ApiService(dio);
  // 确保downloadFile返回的response.data是Uint8List类型（图片字节）
  final response = await client.downloadFile();
  return response.response.data as Uint8List;
}

2. 重构MyApp的build逻辑

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  Future<Uint8List> getData() async {
    final dio = Dio();
    final client = ApiService(dio);
    final response = await client.downloadFile();
    return response.response.data as Uint8List;
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: FutureBuilder<Uint8List>(
          future: getData(),
          builder: (context, AsyncSnapshot<Uint8List> snapshot) {
            if (snapshot.hasData) {
              // 加载成功，显示图片
              return Center(
                child: Image.memory(snapshot.data!),
              );
            } else if (snapshot.hasError) {
              // 处理加载错误
              return Center(
                child: Text('加载失败: ${snapshot.error}'),
              );
            } else {
              // 加载中显示进度条
              return const Center(
                child: CircularProgressIndicator(),
              );
            }
          },
        ),
      ),
    );
  }
}

3. 补充main函数规范

WidgetsFlutterBinding.ensureInitialized()应放在main函数最开头，而非异步方法内：

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MyApp());
}

关键注意事项 #

• 确认ApiService.downloadFile()返回的response.data确实是Uint8List类型，若返回的是文件路径，需对应调整图片加载方式。
• 永远不要在异步函数内调用runApp()，这会破坏原有Widget树结构，导致应用异常重启。

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