Flutter通过MethodChannel调用Android原生方法时，如何传递和接收复杂对象？

UP主～克样提问于 2026-02-15 02:23:23 阅读 44

移动

我现在在做Flutter和Android原生交互，需要从Android返回一个包含用户信息和配置数据的复杂对象。试过把对象转成Map再传递，但Dart端接收后要手动解析字段特别麻烦。比如用户对象里还有嵌套的地址信息，这样写重复代码太多，有没有更优雅的处理方式？

Android这边用的是这样的代码：


public static void getUserInfo(Result result) {
    User user = new User("123", "张三", 
        new Address("北京市", "海淀区"));
    result.success(user.toMap()); // 把对象转成Map返回
}

Flutter端现在这样处理：


final Map<String, dynamic> response = await platform.invokeMethod('getUserInfo');
final user = User(
  id: response['id'],
  name: response['name'],
  address: Address(
    city: response['address']['city'],
    area: response['address']['area'],
  ),
);

这样写嵌套太多层了，如果对象结构复杂的话维护起来会很痛苦，有没有办法让Dart自动解析成对应的Model类？

Flutter 原生交互

我来解答赞 11 收藏

反馈

1 条解答

南宫子钊 Lv1

要优雅地解决这个问题，核心思路是通过序列化和反序列化的机制来自动完成复杂对象的传递和解析。我们可以在两端（Flutter和Android）分别定义对应的Model类，并借助JSON序列化工具来减少手动解析的工作量。

下面分步骤说明具体实现方法：

第一步，在Android端将复杂对象转换为JSON字符串。
你需要确保你的 User 和 Address 类都实现了 toMap() 方法，或者更推荐使用一个通用的JSON序列化库，比如Gson。以Gson为例，你可以这样修改代码：

import com.google.gson.Gson;



public static void getUserInfo(Result result) {

    User user = new User("123", "张三", 

        new Address("北京市", "海淀区"));

    

    // 使用Gson将对象直接转成JSON字符串

    String jsonString = new Gson().toJson(user);

    result.success(jsonString); // 返回JSON字符串

}

注意：这里返回的是JSON字符串而不是Map，因为JSON是一种通用格式，能更好地在Flutter和Android之间传递复杂数据结构。

第二步，在Flutter端接收JSON字符串并解析为Dart对象。
在Flutter中，我们可以借助 json_serializable 包来自动生成序列化代码，避免手动写解析逻辑。首先，你需要在 pubspec.yaml 中添加依赖：

dependencies:

  flutter:

    sdk: flutter

  json_annotation: ^4.8.0



dev_dependencies:

  build_runner: ^2.3.0

  json_serializable: ^6.7.0

然后定义对应的Dart Model类，并使用注解来标记需要序列化的字段：

import 'package:json_annotation/json_annotation.dart';



part 'user.g.dart'; // 自动生成的文件



@JsonSerializable()

class User {

  final String id;

  final String name;

  final Address address;



  User({required this.id, required this.name, required this.address});



  // 自动生成的工厂方法，用于从JSON解析

  factory User.fromJson(Map<String, dynamic> json) => _$UserFromJson(json);



  // 自动生成的方法，用于转成JSON

  Map<String, dynamic> toJson() => _$UserToJson(this);

}



@JsonSerializable()

class Address {

  final String city;

  final String area;



  Address({required this.city, required this.area});



  factory Address.fromJson(Map<String, dynamic> json) => _$AddressFromJson(json);

  Map<String, dynamic> toJson() => _$AddressToJson(this);

}

接着运行 flutter pub run build_runner build 命令，生成 user.g.dart 文件。这个文件会包含 _$UserFromJson 和 _$AddressFromJson 等方法，用来处理JSON的序列化和反序列化。

第三步，在Flutter中调用原生方法并解析返回值。
现在你可以直接接收JSON字符串并自动解析为Dart对象了：

import 'dart:convert';



Future<User> fetchUserInfo() async {

  final String jsonString = await platform.invokeMethod('getUserInfo');

  

  // 将JSON字符串转成Map

  final Map<String, dynamic> jsonMap = jsonDecode(jsonString);

  

  // 自动解析为User对象

  return User.fromJson(jsonMap);

}

这样做有几个好处：
1. Android端只需要把对象转成JSON字符串，Flutter端可以自动解析，减少了手动映射字段的工作量。
2. 如果以后对象结构发生变化，比如新增字段或嵌套层级更深，你只需要更新Model类，不需要改动太多业务代码。
3. JSON是一种通用的数据格式，适合跨平台交互，未来如果扩展到iOS原生代码也更容易适配。

需要注意的是，使用JSON序列化虽然方便，但性能上可能会比直接传递简单类型稍差一些，尤其是在数据量很大的情况下。不过对于大多数应用场景来说，这种性能开销是可以接受的。

最后吐槽一句，搞跨平台开发真是累啊，光是数据传递就要折腾半天。不过有了这套方案，至少能少写点重复代码了。

2026-02-15 03:01