Flutter调用Laravel API返回空数据问题排查求助

我来帮你一步步排查这个问题，从Flutter端到Laravel端逐一验证：

一、Flutter端排查 #

1. 捕获完整请求异常信息 #

你的当前代码没有处理请求异常，很多时候"空数据"其实是请求报错但没被捕获。修改getDatas方法，添加完整的错误捕获：

Future<HeaderList> getDatas() async { 
  try {
    Response datas = await _dio.get('/load/songs'); 
    print('状态码: ${datas.statusCode}');
    print('响应头: ${datas.headers}');
    print('原始响应数据: ${datas.data}'); 
    return HeaderList.fromJson(datas.data); 
  } on DioException catch (e) {
    print('Dio错误类型: ${e.type}');
    print('错误信息: ${e.message}');
    if (e.response != null) {
      print('错误状态码: ${e.response?.statusCode}');
      print('错误响应数据: ${e.response?.data}');
    }
    rethrow;
  } catch (e) {
    print('未知错误: $e');
    rethrow;
  }
}

通过这些打印信息，你能确认：

• 请求是否真的到达了服务器
• 是否有4xx/5xx状态码错误
• 响应数据是否和Postman中完全一致

2. 验证模型类与JSON结构的匹配度 #

这是最常见的问题之一：

• 对比Postman返回的JSON键名和你的模型类解析逻辑，比如你用了json['total data']，要确认API返回的JSON里确实有带空格的键名"total data"，而不是"total"或"totalData"
• 检查artist和songs数组是否存在，且每个子元素的结构和Artist、Song模型的fromJson逻辑完全匹配
  如果键名不匹配，模型类会因无法获取required字段抛出异常，看起来就像返回了空数据。

3. 确认请求URL完全一致 #

确保Dio的baseUrl加上请求路径后，和Postman中使用的URL完全相同：

• 检查是否多/少了斜杠（比如baseUrl末尾是否带斜杠，请求路径开头是否带斜杠）
• 确认spotify.test在Flutter模拟器/真机上能正常解析（可以尝试直接在设备浏览器中访问该URL）

二、Laravel端排查 #

1. 检查路由配置 #

如果你的API路由定义在routes/web.php中，会依赖浏览器的Session Cookie才能访问，但Flutter请求默认不会携带Session，导致返回空数据或被拒绝。请确保路由定义在routes/api.php中：

// routes/api.php
Route::get('/load/songs', [SongController::class, 'loadSongs']);

2. 验证控制器响应格式 #

确保控制器方法返回合法的JSON响应，必须使用response()->json()：

public function loadSongs()
{
    // 替换为你的实际业务逻辑
    $data = [
        'total data' => Song::count(),
        'artist' => Artist::all()->toArray(),
        'songs' => Song::all()->toArray(),
    ];

    // 明确返回JSON格式响应
    return response()->json($data);
}

避免返回视图或其他非JSON格式，否则Flutter无法正确解析。

3. 查看Laravel日志 #

检查storage/logs/laravel.log文件，搜索Flutter请求的时间点，查看是否有服务器端错误：

• SQL查询错误（比如字段不存在、关联表查询失败）
• 控制器方法中的逻辑异常
  日志会清晰告诉你请求是否到达服务器，以及处理过程中是否出现问题。

4. 检查中间件与认证 #

• 如果路由使用了auth:sanctum等认证中间件，要确保Flutter请求中携带了正确的Token（Postman中可能已经添加了Token，但Flutter中遗漏了）
• 如果不需要认证，移除路由上的认证中间件，或者确保中间件允许匿名访问

5. 验证CORS配置（可选） #

虽然Flutter不会像浏览器那样严格限制CORS，但如果Laravel的CORS配置过于严格，可能影响请求。检查config/cors.php：

return [
    'paths' => ['api/*'],
    'allowed_methods' => ['*'],
    'allowed_origins' => ['*'], // 调试阶段可暂时设置为允许所有来源
    'allowed_origins_patterns' => [],
    'allowed_headers' => ['*'],
    'exposed_headers' => [],
    'max_age' => 0,
    'supports_credentials' => false,
];

修改后执行php artisan config:clear清除配置缓存。

建议你先从Flutter端打印的响应数据入手，确认是否和Postman一致；如果不一致，再重点排查Laravel端的路由、控制器和日志。

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