Flutter Google登录：注册时如何向用户集合添加额外数据

在Google Sign In流程完成后，你完全有机会把自定义的额外数据和用户的Gmail默认信息一起存入用户集合，下面分享两种最常用的实现方式：

一、结合Firebase Auth + Cloud Firestore（最常见场景） #

如果你的Flutter项目用了Firebase生态，步骤非常清晰：

1. 先完成基础的Google登录流程，拿到用户的Google认证信息
2. 登录Firebase Auth获取用户凭证
3. 把默认用户信息+自定义额外数据打包，写入Cloud Firestore的用户集合

举个具体的代码示例：

// 触发Google登录
final GoogleSignInAccount? googleUser = await GoogleSignIn().signIn();
if (googleUser == null) return; // 用户取消登录

// 获取Google认证凭证
final GoogleSignInAuthentication googleAuth = await googleUser.authentication;
final credential = GoogleAuthProvider.credential(
  accessToken: googleAuth.accessToken,
  idToken: googleAuth.idToken,
);

// 登录Firebase Auth
final UserCredential userCredential = await FirebaseAuth.instance.signInWithCredential(credential);
final User? firebaseUser = userCredential.user;

if (firebaseUser != null) {
  // 准备包含额外数据的用户信息Map
  final userData = {
    'email': firebaseUser.email,
    'displayName': firebaseUser.displayName,
    'photoURL': firebaseUser.photoURL,
    'createdAt': FieldValue.serverTimestamp(), // 额外字段：服务器端生成的注册时间
    'themePreference': 'light', // 额外字段：用户主题偏好
    'phoneNumber': '', // 后续可让用户补充的字段，先留空
  };

  // 写入Firestore的users集合，用用户UID作为文档ID
  await FirebaseFirestore.instance
      .collection('users')
      .doc(firebaseUser.uid)
      .set(userData);
}

如果后续需要补充或更新额外数据，直接用update方法即可：

await FirebaseFirestore.instance
    .collection('users')
    .doc(firebaseUser.uid)
    .update({'phoneNumber': '1234567890'});

二、自定义后端服务场景 #

如果你的项目用自己搭建的后端，流程是：

1. Google登录成功后，收集用户的Google认证信息（比如idToken）和你需要的额外数据
2. 把这些数据一起发送到后端接口
3. 后端验证Google凭证的合法性后，将所有数据插入到你的数据库用户表中

Flutter端的请求示例：

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

// 登录成功后构建请求数据
final requestData = {
  'idToken': googleAuth.idToken,
  'email': googleUser.email,
  'displayName': googleUser.displayName,
  'extraInfo': {
    'favoriteHobby': 'reading',
    'age': 28
  }
};

// 发送POST请求到后端用户注册接口
final response = await http.post(
  Uri.parse('https://your-backend-domain.com/api/users/register'),
  body: jsonEncode(requestData),
  headers: {'Content-Type': 'application/json'},
);

if (response.statusCode == 200) {
  // 数据插入成功
}

小提示 #

如果想让用户在注册时就填写额外信息，可以在Google登录成功后，弹出一个自定义表单（比如让用户输入年龄、兴趣等），收集完信息后再统一写入数据库，这样用户体验会更连贯。

内容的提问来源于stack exchange，提问作者Dhanuka Perera