Firebase查询大小写不敏感实现：Angular/Ionic邮箱重复校验方案

1. 批量更新现有数据库中的邮箱为小写 #

由于历史数据未做小写处理，首先需要统一User集合里的邮箱字段。可以用Firebase Admin SDK编写批量更新脚本：

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

const db = admin.firestore();

async function lowercaseAllEmails() {
  const usersSnapshot = await db.collection('User').get();
  const batch = db.batch();

  usersSnapshot.forEach(doc => {
    const userData = doc.data();
    if (userData.email && typeof userData.email === 'string') {
      const lowercaseEmail = userData.email.toLowerCase();
      if (lowercaseEmail !== userData.email) {
        batch.update(doc.ref, { email: lowercaseEmail });
      }
    }
  });

  await batch.commit();
  console.log('所有邮箱已统一为小写');
}

lowercaseAllEmails().catch(console.error);

2. 修改注册流程，强制存储小写邮箱 #

在Angular/Ionic的注册逻辑中，对用户输入的邮箱先做小写转换，再写入Firestore：

// 注册组件中的处理逻辑
async registerUser(email: string, password: string, otherData: any) {
  // 转换邮箱为小写
  const lowercaseEmail = email.toLowerCase();
  
  // 先执行重复校验（见下一步）
  const exists = await this.checkEmailExists(lowercaseEmail);
  if (exists) {
    throw new Error('该邮箱已被注册');
  }

  // 写入Firestore，存储小写后的邮箱
  await firestore.collection('User').add({
    email: lowercaseEmail,
    // 可选：保留用户原始输入的邮箱格式
    originalEmail: email,
    ...otherData
  });

  // 后续认证逻辑示例
  // await auth.createUserWithEmailAndPassword(lowercaseEmail, password);
}

3. 修改重复校验的查询逻辑 #

校验时将输入的邮箱转为小写，再执行查询：

async checkEmailExists(email: string): Promise<boolean> {
  const lowercaseEmail = email.toLowerCase();
  const snapshot = await firestore
    .collection('User')
    .where('email', '==', lowercaseEmail)
    .get();
  
  return !snapshot.empty;
}

4. 可选：添加Firestore安全规则保障数据一致性 #

为防止前端逻辑被绕过，在Firestore安全规则中限制只有小写邮箱才能写入User集合：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /User/{userId} {
      allow create: if request.resource.data.email == request.resource.data.email.toLowerCase();
      allow update: if request.resource.data.email == request.resource.data.email.toLowerCase();
    }
  }
}

通过以上步骤，即可彻底解决邮箱大小写导致的重复注册问题，实现统一的小写邮箱存储与校验逻辑。

内容的提问来源于stack exchange，提问作者slhn.dev