Flutter中基于Firebase Auth实现新用户注册需管理员审核的方法

核心逻辑为新增「待审核用户临时池」，完全阻断未审核用户直接调用Firebase注册接口的路径，所有正式账户仅能由管理员审核后通过Admin SDK创建，从规则侧彻底禁止未授权用户写入Firestore。

1. 调整Flutter端注册流程 #

用户提交注册信息（含邮箱、申请角色、OTP校验结果）后，禁止直接调用createUserWithEmailAndPassword接口，仅将加密后的注册信息写入专门的pending_users Firestore集合，完成注册申请提交。

2. 配置Firestore安全规则 #

给pending_users和其他业务集合配置规则，从底层拦截未授权访问：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // 待审核用户集合规则：未认证用户仅可提交申请，仅管理员可读写
    match /pending_users/{pendingId} {
      allow create: if request.auth == null;
      allow read, update, delete: if request.auth != null && isAdmin(request.auth.uid);
    }
    // 所有业务集合仅已认证的正式用户可访问
    match /{document=**} {
      allow read, write: if request.auth != null;
    }
    // 管理员身份校验逻辑，提前将管理员uid写入admins集合即可
    function isAdmin(uid) {
      return exists(/databases/$(database)/documents/admins/$(uid));
    }
  }
}

3. 管理员审核流程实现 #

管理员在后台审核pending_users集合内的申请，审核通过后调用Firebase Admin SDK创建正式身份，示例代码（Node.js云函数/私有后端通用）：

const admin = require('firebase-admin');
admin.initializeApp();

// 审核通过后触发的用户创建方法
async function approvePendingUser(pendingUserId) {
  const pendingUserRef = admin.firestore().collection('pending_users').doc(pendingUserId);
  const pendingUserSnap = await pendingUserRef.get();
  if (!pendingUserSnap.exists) throw new Error('invalid pending user');
  
  const userInfo = pendingUserSnap.data();
  // 创建Firebase Auth正式账户
  const newUser = await admin.auth().createUser({
    email: userInfo.email,
    password: userInfo.encryptedPassword,
    displayName: userInfo.displayName
  });
  // 写入正式用户集合，绑定角色
  await admin.firestore().collection('users').doc(newUser.uid).set({
    email: userInfo.email,
    role: userInfo.requestedRole, // 可选值：管理员/工程师/技术人员
    createdAt: admin.firestore.FieldValue.serverTimestamp()
  });
  // 删除临时待审核记录
  await pendingUserRef.delete();
  return newUser.uid;
}

4. 前端登录适配 #

用户收到审核通过通知后，直接调用signInWithEmailAndPassword接口完成登录即可，登录后从users集合拉取角色信息做前端权限控制。

注意事项 #

• OTP校验必须在用户提交注册申请前完成，避免无效垃圾数据写入临时集合
• pending_users集合内存储的用户密码需做对称加密，禁止明文存储
• Admin SDK密钥禁止暴露在前端侧，所有正式账户创建操作必须走有权限校验的后端或云函数

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