Flutter Flushbar仅显示错误信息首字符，Dio处理响应错误丢字如何解决？

云上老周

2026-9-24

问题根因

你遇到的只返回错误首字符的问题基本都是ErrorGroup的解析逻辑错误导致的，常见触发原因如下：

服务端返回的response.data是键为phone_number、值为错误信息的Map结构，但你的fromJson方法错误地把整个Map/错误字符串当成了数组取[0]下标，只截取了第一个字符。
fromJson中错误读取了不存在的字段：比如你写死了取data['detail']，但当前场景下服务端返回的错误字段是phone_number，取到空值后后续处理逻辑错误只返回了首字符。
Dio响应配置错误：误将responseType设置为bytes/stream，字节转字符串时只读取了第一个字节对应的字符。
ErrorGroup的errorString字段类型定义错误，比如错误声明为字符类型而非字符串类型，序列化时仅保留了首字符。

排查&修复步骤

首先确认响应数据类型，添加日志打印结构确认：

print("响应数据类型：${dioError.response.data.runtimeType}");
print("phone_number字段值：${dioError.response.data['phone_number']}");

修正ErrorGroup.fromJson的解析逻辑，兼容不同的错误返回字段：

class ErrorGroup {
  final int? statusCode;
  final String errorString;

  ErrorGroup({required this.statusCode, required this.errorString});

  factory ErrorGroup.fromJson(Map<String, dynamic> json, int? statusCode) {
    String errorMsg;
    // 按优先级匹配错误字段
    if (json.containsKey('detail')) {
      errorMsg = json['detail'] as String;
    } else if (json.containsKey('phone_number')) {
      errorMsg = json['phone_number'] as String;
    } else {
      errorMsg = '服务器错误';
    }
    // 禁止添加 errorMsg[0] 这类截取首字符的逻辑
    return ErrorGroup(
      statusCode: statusCode,
      errorString: errorMsg,
    );
  }
}