如何在Dart HTTP GET请求中正确添加嵌套查询参数？解决类型错误

算力阿峰

2026-8-21

问题分析与解决方案

你遇到的错误是因为Uri.http的第三个参数要求传入Map<String, String>或Map<String, Iterable<String>>类型的查询参数，但你的query是包含嵌套Map的Map<String, dynamic>（其中params是子Map），这种复杂结构无法直接转换为URL查询参数，导致类型不匹配。

方案1：将JSON结构转为字符串作为单个查询参数传递

如果后端要求通过GET请求的查询参数传递完整的JSON-RPC结构，需要把整个query序列化为JSON字符串，再作为单个参数传入：

import 'dart:convert';
import 'package:http/http.dart' as http;

// ... 你的其他变量定义代码

// 将嵌套的query序列化为JSON字符串
String queryJson = jsonEncode(query);
// 构造符合要求的查询参数Map
Map<String, String> queryParams = {'data': queryJson};

Uri uri = Uri.http(baseUrl.toString(), '$path/$endPath', queryParams);
return http.get(uri, headers: {
  'Authorization': 'Bearer $token',
  'Accept': 'application/json',
});

方案2：改用POST请求传递JSON-RPC数据

JSON-RPC规范通常推荐使用POST请求，将复杂JSON数据放在请求体中，这更适配复杂结构的传递：

import 'dart:convert';
import 'package:http/http.dart' as http;

// ... 你的其他变量定义代码

Uri uri = Uri.http(baseUrl.toString(), '$path/$endPath');
return http.post(uri, 
  headers: {
    'Authorization': 'Bearer $token',
    'Accept': 'application/json',
    'Content-Type': 'application/json', // 必须添加该头部，告知后端请求体格式
  },
  body: jsonEncode(query), // 将完整的query作为请求体发送
);