未对Map调用json.encode发送POST请求触发length空调用错误原因咨询

数据老陈

2026-5-14

问题原因分析：The getter 'length' was called on null 错误

我来帮你拆解这个错误的核心原因，其实和你传入的data是否非空关系不大，问题出在Dart http库对body参数的处理逻辑上：

1. 直接传Map给`body`时的隐形坑

当你把Map类型的data直接传给http.post的body参数时，http库会默认按照application/x-www-form-urlencoded格式来自动序列化这个Map。这个序列化逻辑有个限制：它只支持简单类型的键值对（比如String、int、bool这类能直接转成字符串的值）。

如果你的Map里包含了嵌套的Map、List，或者其他无法直接转成form字段的复杂类型，这个自动序列化操作就会失败，内部生成的实际请求体内容会变成null。

2. 错误的触发点

http.post在发送请求前，会尝试获取请求体的length属性来设置对应的请求头。当序列化失败导致请求体是null时，调用null的length属性自然就会抛出The getter 'length' was called on null这个错误。

为什么`json.encode(data)`能解决问题？

当你用json.encode(data)把Map转换成JSON字符串后：

body参数变成了String类型，http库会直接把这个字符串作为请求体发送，不会再做额外的序列化操作，避免了转换失败的问题。
这里额外建议你在headers里加上"Content-Type": "application/json"，明确告诉服务器你发送的是JSON格式的数据（你已经加了Accept头，它是用来声明期望接收的响应格式，而Content-Type是声明请求体的格式，二者作用不同）。