You need to enable JavaScript to run this app. 如何解决Flutter开发中“type Null is not a subtype of type int”报错
优惠活动
大模型
产品
解决方案
定价
更多

如何解决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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.17 14:45:08