Flutter中fromJson报错：String无法转为Map<String, dynamic>

错误type 'String' is not a subtype of type 'Map<String, dynamic>'的核心原因是：你传给User.fromJson()的response是原始JSON字符串，而不是解析后的Map<String, dynamic>类型。你的API返回的JSON格式是正确的，但ApiClient().post()方法返回的是未解析的字符串，而User.fromJson()需要的是解析后的Map对象。

解决方案一：手动解析JSON字符串 #

在调用User.fromJson()之前，先用jsonDecode()把字符串转成Map，步骤如下：

1. 导入dart:convert包：

import 'dart:convert';

2. 修改createUser()函数：

Future<User> createUser() async {
  String email = _emailController.text;
  String password = _passwordController.text;
  final response = await ApiClient().post("/register", RegisterDTO(email, password));
  // 将JSON字符串解析为Map
  final userJson = jsonDecode(response) as Map<String, dynamic>;
  return User.fromJson(userJson);
}

解决方案二：修改ApiClient的post方法（更推荐） #

如果希望ApiClient直接返回解析后的Map，避免每次调用都手动解析，可以修改ApiClient的post实现（假设你用的是http包）：

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

class ApiClient {
  // 替换成你的API基础地址
  final String baseUrl = "https://your-api-domain.com";

  Future<Map<String, dynamic>> post(String endpoint, RegisterDTO body) async {
    final url = Uri.parse("$baseUrl$endpoint");
    final response = await http.post(
      url,
      headers: {"Content-Type": "application/json"},
      body: jsonEncode(body.toJson()), // 假设RegisterDTO有toJson方法
    );

    if (response.statusCode == 200) {
      // 直接返回解析后的Map
      return jsonDecode(response.body) as Map<String, dynamic>;
    } else {
      throw Exception("注册失败，状态码：${response.statusCode}");
    }
  }
}

修改后，原来的createUser()函数就可以保持原样，因为response已经是解析好的Map了。

额外检查点 #

• 确认RegisterDTO类有正确的toJson()方法，能将对象转成JSON字符串传给API；
• 检查API返回的Content-Type是否为application/json，避免解析异常；
• 如果ApiClient返回的是http.Response对象（而不是字符串），那你需要先取response.body再解析。

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