Flutter登录函数报错：type 'Null' is not a subtype of type 'String'求助

错误原因分析 #

出现type 'Null' is not a subtype of type 'String'的常见原因有以下3种：

• 控制器未初始化或文本为空处理缺失：_emailController或_passwordController未在initState中初始化，导致调用.text时返回null，而LoginUser的emailId/password字段要求非空String类型。
• API响应模型字段定义错误：CustomerLoginResponse的message字段被定义为非空String，但实际API返回的响应中该字段为null，解析模型时触发类型不匹配错误。
• 错误处理逻辑冗余：代码中同时使用.catchError()和try-catch，可能导致错误捕获后返回的异常对象被错误解析为响应对象，引发类型问题。

对应解决方法 #

1. 确保控制器正确初始化并处理空文本 #

在State类的initState中初始化控制器，并在dispose时释放资源：

@override
void initState() {
  super.initState();
  _emailController = TextEditingController();
  _passwordController = TextEditingController();
}

@override
void dispose() {
  _emailController.dispose();
  _passwordController.dispose();
  super.dispose();
}

创建LoginUser对象时可添加空值兜底：

var user = LoginUser(
  emailId: _emailController.text.trim().isEmpty ? '' : _emailController.text,
  password: _passwordController.text.trim().isEmpty ? '' : _passwordController.text,
);

2. 修正响应模型的字段定义 #

将CustomerLoginResponse中的message字段改为可空类型，并在JSON解析时兼容null值：

class CustomerLoginResponse {
  final bool successful;
  final String? message;

  CustomerLoginResponse({required this.successful, this.message});

  factory CustomerLoginResponse.fromJson(Map<String, dynamic> json) {
    return CustomerLoginResponse(
      successful: json['successful'] as bool? ?? false,
      message: json['message'] as String?,
    );
  }
}

使用message时添加空值判断：

print(response.message ?? '无提示信息');

3. 简化错误处理逻辑 #

移除冗余的.catchError()，直接用try-catch包裹API调用，逻辑更清晰：

void _login() async {
  var user = LoginUser(
    emailId: _emailController.text,
    password: _passwordController.text,
  );

  try {
    CustomerLoginResponse response = await ApiManager().loginUser(user);
    if (response.successful) {
      showDataAlert();
      print(response.message ?? '登录成功');
    } else {
      print(response.message ?? '登录失败');
    }
  } catch (e) {
    print('登录异常：$e');
  }
}

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