React Native项目Firebase自定义注册表单：用户额外信息存储与检索

嘿，这个问题我在项目里经常遇到，Firebase Auth确实只默认管理邮箱、密码这类核心认证字段，但要存储姓名、手机号、性别这些用户额外信息其实很简单，主要是配合Firebase的Firestore或者Realtime Database来做，下面给你详细拆解步骤：

核心思路是：先通过Firebase Auth完成邮箱密码的注册流程，拿到用户的唯一标识uid，再把额外信息绑定这个uid存入数据库，这样就能和Auth系统里的用户一一对应。

1. 用Firestore存储（推荐，适合结构化数据） #

Firestore是NoSQL文档型数据库，非常适合存储用户这类结构化信息。代码示例：

import { getAuth, createUserWithEmailAndPassword } from "firebase/auth";
import { getFirestore, doc, setDoc } from "firebase/firestore";

// 初始化Auth和Firestore实例
const auth = getAuth();
const db = getFirestore();

// 处理注册表单提交
const handleRegister = async (formData) => {
  const { name, phone, gender, email, password } = formData;
  try {
    // 第一步：完成Firebase Auth注册
    const userCredential = await createUserWithEmailAndPassword(auth, email, password);
    const user = userCredential.user;

    // 第二步：将额外信息存入Firestore，用用户uid作为文档ID
    await setDoc(doc(db, "users", user.uid), {
      name,
      phone,
      gender,
      email: user.email, // 可选：把邮箱也存一份方便查询
      createdAt: new Date()
    });

    alert("注册成功！");
  } catch (error) {
    console.error("注册失败：", error.message);
    alert(`注册失败：${error.message}`);
  }
};

这里用user.uid作为Firestore文档的ID，能保证每个用户的信息文档和Auth账号严格绑定，后续检索会非常方便。

2. 用Realtime Database存储（适合实时同步场景） #

如果你的项目需要实时数据同步，也可以用Realtime Database，代码类似：

import { getAuth, createUserWithEmailAndPassword } from "firebase/auth";
import { getDatabase, ref, set } from "firebase/database";

const auth = getAuth();
const db = getDatabase();

const handleRegister = async (formData) => {
  const { name, phone, gender, email, password } = formData;
  try {
    const userCredential = await createUserWithEmailAndPassword(auth, email, password);
    const user = userCredential.user;

    // 存入Realtime Database，路径为users/用户uid
    await set(ref(db, `users/${user.uid}`), {
      name,
      phone,
      gender,
      email: user.email
    });

    alert("注册成功！");
  } catch (error) {
    console.error("注册失败：", error.message);
    alert(`注册失败：${error.message}`);
  }
};

根据不同场景，检索方式分为两种：

1. 获取当前登录用户的信息 #

通常我们需要在用户登录后获取其个人信息，这里可以配合Auth的状态监听：

import { getAuth, onAuthStateChanged } from "firebase/auth";
import { getFirestore, doc, getDoc } from "firebase/firestore";

const auth = getAuth();
const db = getFirestore();

// 监听用户登录状态变化
onAuthStateChanged(auth, async (user) => {
  if (user) {
    // 用户已登录，从Firestore获取其额外信息
    const userDocRef = doc(db, "users", user.uid);
    const userDoc = await getDoc(userDocRef);
    
    if (userDoc.exists()) {
      const userData = userDoc.data();
      console.log("当前用户信息：", userData);
      // 这里可以把userData存入组件状态，供页面渲染使用
    } else {
      console.log("未找到该用户的额外信息");
    }
  } else {
    // 用户未登录，做相应处理（比如跳转到登录页）
    console.log("用户已退出登录");
  }
});

2. 查询其他用户的信息 #

如果需要通过手机号、姓名等字段查询其他用户（比如通讯录匹配），可以用Firestore的查询功能：

import { getFirestore, collection, query, where, getDocs } from "firebase/firestore";

const db = getFirestore();

// 通过手机号查询用户
const getUserByPhone = async (phoneNumber) => {
  try {
    // 构建查询条件：users集合中phone字段等于目标手机号
    const q = query(collection(db, "users"), where("phone", "==", phoneNumber));
    const querySnapshot = await getDocs(q);
    
    querySnapshot.forEach((doc) => {
      console.log("找到匹配用户：", doc.data());
      // 处理查询到的用户数据
    });
  } catch (error) {
    console.error("查询失败：", error.message);
  }
};

• 安全规则必须配置：为了防止用户越权访问或修改他人信息，一定要设置数据库的安全规则。比如Firestore的规则可以这样写：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      // 只有登录用户且uid匹配，才能读写自己的信息
      allow read, write: if request.auth != null && request.auth.uid == userId;
    }
  }
}

• 更新信息用updateDoc：如果用户后续需要修改个人信息，不要用setDoc（会覆盖整个文档），改用updateDoc只更新需要修改的字段：

await updateDoc(doc(db, "users", user.uid), {
  phone: newPhoneNumber,
  name: newName
});

• 自定义Claims慎用：Firebase Auth提供了自定义Claims功能，但它更适合存储权限类信息（比如用户角色），不适合存储大量个人信息，因为Claims有大小限制（1KB），且会随IDToken一起传输，影响性能。

内容的提问来源于stack exchange，提问作者Billy Ronaldo Chandra