HTTP 请求

Flutter 中进行网络请求需要使用第三方包。

安装

flutter pub add http

GET 请求

import 'package:http/http.dart' as http;
import 'dart:convert';

Future<List<User>> fetchUsers() async {
  final response = await http.get(
    Uri.parse('https://jsonplaceholder.typicode.com/users'),
  );

  if (response.statusCode == 200) {
    final List<dynamic> data = json.decode(response.body);
    return data.map((json) => User.fromJson(json)).toList();
  } else {
    throw Exception('请求失败: ${response.statusCode}');
  }
}

POST 请求

Future<User> createUser(String name, String email) async {
  final response = await http.post(
    Uri.parse('https://jsonplaceholder.typicode.com/users'),
    headers: {'Content-Type': 'application/json'},
    body: json.encode({
      'name': name,
      'email': email,
    }),
  );

  if (response.statusCode == 201) {
    return User.fromJson(json.decode(response.body));
  } else {
    throw Exception('创建失败');
  }
}

带状态管理的请求

class UserListPage extends StatefulWidget {
  // ...
}

class _UserListPageState extends State<UserListPage> {
  List<User> _users = [];
  bool _isLoading = true;
  String? _error;

  @override
  void initState() {
    super.initState();
    _loadUsers();
  }

  Future<void> _loadUsers() async {
    try {
      setState(() {
        _isLoading = true;
        _error = null;
      });
      _users = await Api.fetchUsers();
    } catch (e) {
      _error = e.toString();
    } finally {
      setState(() => _isLoading = false);
    }
  }

  @override
  Widget build(BuildContext context) {
    if (_isLoading) return const CircularProgressIndicator();
    if (_error != null) return Text('错误: $_error');
    return ListView.builder(
      itemCount: _users.length,
      itemBuilder: (context, index) => ListTile(
        title: Text(_users[index].name),
      ),
    );
  }
}

带超时和 Header 的请求

final response = await http.get(
  Uri.parse('https://api.example.com/data'),
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer $token',
  },
).timeout(const Duration(seconds: 10));

进阶：dio

当项目需要拦截器、全局配置、文件上传下载、请求取消等能力时，推荐使用 dio 替代 http 包。

http vs dio

特性	http	dio
官方包	是	第三方
拦截器	无	有
请求取消	手动	内置
表单/文件上传	手动	内置
重试机制	无	内置
全局配置	无	BaseOptions
错误类型	通用 Exception	DioException（细分类型）

详见 dio 网络请求。