Flutter MethodChannel传递复杂参数时出现类型转换错误怎么办？

你这个问题其实挺典型的，本质是 MethodChannel 传输的数据类型限制 + 原生层方法签名不匹配导致的。

Flutter 的 MethodChannel 在跨平台通信时，只支持以下几种基础类型：null、bool、int、double、String、List、Map（且 Map 的 key 必须是 String，value 也必须是这些支持的类型）。你传的嵌套 Map 是支持的，没问题。

但问题出在 Android 原生层——你定义的是 public void nativeMethod(String data)，这个方法签名要求参数必须是 String 类型，而 Flutter 实际传过来的是一个 Map 对象，所以系统直接报“无法将 Map 转换为 String”。

有两种解法：

第一种（推荐）：改原生方法签名，让它接收 Map，然后你在原生层自己转 JSON 字符串。这样更灵活，也更符合 Flutter 的设计思路。比如 Android 端改成：

public void nativeMethod(Object data, MethodChannel.Result result) {

    if (data instanceof Map) {

        try {

            String json = new JSONObject((Map) data).toString();

            // 后续用 json 做你自己的逻辑

        } catch (Exception e) {

            result.error("ERROR", e.getMessage(), null);

        }

    } else {

        result.error("INVALID_PARAM", "expected Map", null);

    }

}

注意方法签名必须是 public void methodName(Object data, MethodChannel.Result result)，Flutter 调用时传 Map 就能自动映射到这个方法。

第二种：真要传 JSON 字符串，那就在 Flutter 端手动序列化，比如：

final jsonString = jsonEncode(params);（记得 import dart:convert），然后传 jsonString 这个 String 给原生层，原生层用 new JSONObject(dataString) 解析。

不过建议用第一种，因为 Flutter 官方是鼓励直接传 Map 的，后续扩展字段也方便，你也不用自己处理 JSON 编解码的坑（比如 null 处理、类型精度丢失这些）。

对了，如果用了第一种方案，记得检查你注册的 MethodChannel 方法名是不是拼写一致，这个也经常出问题……我上次就栽在这上面，调试半小时才发现方法名多打了个 s。

确实会报错，因为你在Flutter端传的是Map类型，但原生Android接收的是String类型。这种情况最简单的解决办法就是在Flutter端先把Map转成JSON字符串再传过去。

直接贴代码吧：

import 'dart:convert';



static const platform = MethodChannel('samples.flutter.dev/battery');

Map<String, dynamic> params = {

  'name': 'test',

  'value': 123,

  'nested': {'id': 456}

};

try {

  // 转成JSON字符串

  String jsonString = jsonEncode(params);

  final result = await platform.invokeMethod('nativeMethod', jsonString);

} catch (e) {

  print(e);

}

然后在Android端接收时，记得把String再解析回Map：

public void nativeMethod(String data) {

    try {

        JSONObject jsonObject = new JSONObject(data);

        String name = jsonObject.getString("name");

        int value = jsonObject.getInt("value");

        JSONObject nested = jsonObject.getJSONObject("nested");

        int id = nested.getInt("id");



        // 做你的逻辑处理

    } catch (JSONException e) {

        e.printStackTrace();

    }

}

这样改完复制过去试试，应该就没问题了。JSON序列化反序列化是最常用的解决方案，别忘了导json包。