Flutter中如何保存响应中的会话Cookie并在请求中传递以维持登录会话？

在Flutter里处理API登录后的Cookie存储和会话维持，主要有两种实用方案，根据需求选择即可：

一、自动Cookie管理（推荐） #

借助cookie_jar包配合http客户端，能自动处理Cookie的存储、更新和携带，无需手动操作。

步骤： #

1. 添加依赖到pubspec.yaml：

dependencies:
  http: ^0.13.5
  cookie_jar: ^4.0.1

2. 初始化持久化Cookie容器：

import 'package:cookie_jar/cookie_jar.dart';
import 'package:http/http.dart' as http;
import 'package:path_provider/path_provider.dart';

// 获取本地存储路径
Future<String> getCookiePath() async {
  final dir = await getApplicationDocumentsDirectory();
  return '${dir.path}/cookies';
}

// 初始化带Cookie管理的客户端
Future<http.Client> getCookieClient() async {
  final cookieJar = PersistentCookieJar(storage: FileStorage(await getCookiePath()));
  final client = http.Client();
  client.interceptors.add(CookieManager(cookieJar));
  return client;
}

3. 发起登录及后续请求：

// 登录请求，Cookie会自动存储
Future<void> login(String username, String password) async {
  final client = await getCookieClient();
  await client.post(
    Uri.parse('https://your-api-domain.com/login'),
    body: {'username': username, 'password': password},
  );
}

// 后续请求自动携带Cookie
Future<void> fetchProtectedData() async {
  final client = await getCookieClient();
  final response = await client.post(
    Uri.parse('https://your-api-domain.com/protected-endpoint'),
    body: {'key': 'value'},
  );
  // 处理响应数据
}

二、手动存储与携带Cookie #

如果需要更精细的Cookie控制，可使用shared_preferences手动存储登录后获取的Cookie，请求时再手动添加到请求头。

步骤： #

1. 添加依赖：

dependencies:
  http: ^0.13.5
  shared_preferences: ^2.2.2

2. 登录时提取并存储Cookie：

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

Future<bool> login(String username, String password) async {
  final response = await http.post(
    Uri.parse('https://your-api-domain.com/login'),
    body: {'username': username, 'password': password},
  );

  if (response.statusCode == 200) {
    // 从响应头提取Set-Cookie值
    final cookie = response.headers['set-cookie'];
    if (cookie != null) {
      final prefs = await SharedPreferences.getInstance();
      await prefs.setString('session_cookie', cookie);
      return true;
    }
  }
  return false;
}

3. 请求时手动携带Cookie：

Future<void> sendAuthenticatedRequest() async {
  final prefs = await SharedPreferences.getInstance();
  final cookie = prefs.getString('session_cookie');

  if (cookie != null) {
    final response = await http.post(
      Uri.parse('https://your-api-domain.com/protected-endpoint'),
      headers: {'Cookie': cookie}, // 将Cookie添加到请求头
      body: {'data': 'your-request-data'},
    );
    // 处理响应
  }
}

注意事项： #

• 手动存储时，建议解析Cookie的expires字段，定期清理失效的Cookie，避免无效请求。
• 若API使用Session ID而非传统Cookie，可将Session ID存储后，通过Authorization头或自定义请求头传递，逻辑类似。

内容的提问来源于stack exchange，提问作者Ananta Dev Datta