如何解决Flutter开发中“type Null is not a subtype of type int”报错
报错原因
你遇到的type Null is not a subtype of type int报错由两个核心问题导致:
- API返回结构和你的解析逻辑不匹配:你请求的
https://reqres.in/api/users?page=2接口返回的根结构为{"page":2,"per_page":6,"total":12,"total_pages":2,"data":[用户数组],"support":{...}},用户数据全部嵌套在根节点的data数组内,你直接将整个响应的JSON传给data类的fromJson方法,根JSON中不存在id、email等字段,取值结果全部为null,赋值给你定义的非空int/String`类型属性时触发类型错误。 - 模型类未做兼容处理:未对后端可能返回的空字段、字段类型变化情况做判断,直接取值赋值给非空类型会直接触发崩溃。
解决方案
第一步:调整模型类,新增外层响应模型并添加空值兼容
// 类名遵循Dart大驼峰命名规范,避免和字段名冲突 class Data { // 属性改为可空类型,或在解析时指定默认值 final int? id; final String? email; final String? firstName; final String? lastName; final String? avatar; Data({ this.id, this.email, this.firstName, this.lastName, this.avatar, }); factory Data.fromJson(Map<String, dynamic> json) { return Data( // 解析时增加类型转换和空判断 id: json['id'] as int?, email: json['email'] as String?, firstName: json['first_name'] as String?, lastName: json['last_name'] as String?, avatar: json['avatar'] as String?, ); } } // 新增接口返回的根结构模型 class ApiResponse { final int? page; final List<Data>? data; ApiResponse({this.page, this.data}); factory ApiResponse.fromJson(Map<String, dynamic> json) { // 解析嵌套的用户数组 var dataList = json['data'] as List?; List<Data> userList = dataList?.map((item) => Data.fromJson(item)).toList() ?? []; return ApiResponse( page: json['page'] as int?, data: userList, ); } }
如果你需要属性非空,可以在解析时指定默认值,示例:id: json['id'] ?? 0,email: json['email'] ?? '',
第二步:修改API请求逻辑,解析外层结构
import 'dart:async'; import 'dart:convert'; import 'package:api_data/models/datamodel.dart'; import 'package:http/http.dart' as http; class ApiManager { // 接口返回用户列表,修改返回值为List<Data> Future<List<Data>> fetchUsers() async { final response = await http.get(Uri.parse('https://reqres.in/api/users?page=2')); if (response.statusCode == 200) { ApiResponse res = ApiResponse.fromJson(jsonDecode(response.body)); return res.data ?? []; } else { throw Exception('Failed to load user data'); } } }
第三步:修改页面代码适配列表渲染逻辑
import 'package:api_data/models/datamodel.dart'; import 'package:api_data/network/api_data.dart'; import 'package:flutter/material.dart'; class Testpage extends StatefulWidget { const Testpage({Key? key}) : super(key: key); @override _TestpageState createState() => _TestpageState(); } class _TestpageState extends State<Testpage> { late Future<List<Data>> futureUsers; @override void initState() { super.initState(); futureUsers = ApiManager().fetchUsers(); } @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar(title: const Text('Test2'), centerTitle: true), body: Center( child: FutureBuilder<List<Data>>( future: futureUsers, builder: (context, snapshot) { if (snapshot.hasData) { // 示例展示第一个用户的邮箱,也可以用ListView展示全部用户 return Text(snapshot.data?.first.email ?? '无可用邮箱数据'); } else if (snapshot.hasError) { return Text("${snapshot.error}"); } return const CircularProgressIndicator(); }, ), ), ); } }
优化建议
- 所有JSON解析步骤都建议增加类型判断和空值兼容,避免后端字段变更、返回异常导致的崩溃。
- 类名、变量名遵循Dart官方命名规范,降低命名冲突风险。
内容的提问来源于stack exchange,提问作者Yasith Samarawickrama
相关产品推荐
相关产品推荐

