如何在Java中实现Dart的Map<String, dynamic> payload转换为Java HashMap？

这问题我做Flutter和Android原生交互时也踩过坑，核心就是类型不匹配导致的转换失败，咱们一步步捋清楚：

为什么你的Java代码跑不起来？ #

你写的HashMap<String, String> payload = new HashMap<>(intent.getSerializableExtra("payload"));有两个关键问题：

1. 泛型类型错误：原Dart Map里的值类型多样——有整数（id、uniqueId）、字符串（name）、还有嵌套了Map的列表，显然不能全部转成String，强行指定<String, String>会直接抛出ClassCastException。
2. 类型转换不安全：intent.getSerializableExtra("payload")返回的是Object类型，直接传给HashMap构造器，编译器无法做类型校验，运行时很容易出问题。

正确的Java实现方式 #

方式1：直接强转成HashMap<String, Object>

Flutter跨端传递的Map<String, dynamic>会被自动序列化为HashMap<String, Object>，列表会变成ArrayList，嵌套Map也是HashMap，所以直接强转即可：

// 直接强转，Flutter端传递的payload默认是HashMap类型
HashMap<String, Object> payload = (HashMap<String, Object>) intent.getSerializableExtra("payload");

之后取值时根据实际类型强转，建议加上instanceof判断避免类型转换异常：

// 取id（Integer类型）
if (payload.get("id") instanceof Integer) {
    Integer id = (Integer) payload.get("id");
}

// 取name（String类型）
if (payload.get("name") instanceof String) {
    String name = (String) payload.get("name");
}

// 取books列表，里面是嵌套的HashMap
if (payload.get("books") instanceof List) {
    List<HashMap<String, Object>> books = (List<HashMap<String, Object>>) payload.get("books");
    // 遍历书籍列表
    for (HashMap<String, Object> book : books) {
        Integer bookId = (Integer) book.get("id");
        String bookTitle = (String) book.get("title");
    }
}

方式2：转成Java实体类（更优雅）

如果字段较多，手动强转太麻烦，可以用Gson这类序列化库把HashMap转成对应的实体类：
首先定义和Dart Map结构一致的Java类：

// 书籍实体类
class Book {
    private int id;
    private String title;

    // 生成getter、setter方法
    public int getId() { return id; }
    public void setId(int id) { this.id = id; }
    public String getTitle() { return title; }
    public void setTitle(String title) { this.title = title; }
}

// 主实体类
class Payload {
    private int id;
    private String name;
    private long uniqueId;
    private List<Book> books;

    // 生成getter、setter方法
    public int getId() { return id; }
    public void setId(int id) { this.id = id; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public long getUniqueId() { return uniqueId; }
    public void setUniqueId(long uniqueId) { this.uniqueId = uniqueId; }
    public List<Book> getBooks() { return books; }
    public void setBooks(List<Book> books) { this.books = books; }
}

然后用Gson完成转换：

import com.google.gson.Gson;

// 获取序列化的payload
Object payloadObj = intent.getSerializableExtra("payload");
// 先转成JSON字符串，再转成实体类
Gson gson = new Gson();
Payload payload = gson.fromJson(gson.toJson(payloadObj), Payload.class);

// 直接通过实体类取值，不用手动强转
int id = payload.getId();
String name = payload.getName();
List<Book> books = payload.getBooks();

注意事项 #

• 确保Flutter端传递数据时用的是支持序列化的方式，比如通过MethodChannel传递或者Intent的putSerializableExtra，Dart的Map默认是支持序列化的。
• 如果遇到ClassCastException，先检查传递的数据类型是否和预期一致，比如Dart里的int在Java里是Integer（不是Long，除非Dart里用的是BigInt）。

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