Flutter中自定义Firebase认证：替换邮箱字段的实现方法

1. 搭建认证后端服务器 #

你需要一个独立的后端服务来处理自定义凭证的验证和Token生成，这里以Node.js + Express为例：

• 初始化项目并安装依赖：

  npm init -y
  npm install firebase-admin express cors bcrypt
  

• 在Firebase控制台下载服务账号密钥（JSON格式），放在项目目录下，然后初始化Firebase Admin SDK：

  const admin = require('firebase-admin');
  const serviceAccount = require('./your-service-account-key.json');
  
  admin.initializeApp({
    credential: admin.credential.cert(serviceAccount)
  });
  

2. 验证自定义凭证（如用户名+密码） #

后端需要存储用户的自定义凭证信息（推荐用Firestore或其他数据库），核心逻辑是验证用户提交的凭证是否合法：

• 编写接口接收前端传来的用户名和密码，完成验证：

  const express = require('express');
  const bcrypt = require('bcrypt');
  const db = admin.firestore();
  const app = express();
  app.use(cors());
  app.use(express.json());
  
  app.post('/verify-login', async (req, res) => {
    const { username, password } = req.body;
    // 从数据库查询对应用户
    const userQuery = await db.collection('users').where('username', '==', username).get();
    
    if (userQuery.empty) {
      return res.status(404).json({ error: '用户不存在' });
    }
  
    const userData = userQuery.docs[0].data();
    // 对比密码哈希（存储时必须用bcrypt加密）
    const isPasswordValid = await bcrypt.compare(password, userData.password_hash);
    
    if (!isPasswordValid) {
      return res.status(401).json({ error: '密码错误' });
    }
  
    // 验证通过，进入Token生成步骤
    const uid = userQuery.docs[0].id;
    const customToken = await admin.auth().createCustomToken(uid);
    res.json({ token: customToken });
  });
  
  app.listen(3000, () => console.log('后端服务运行在3000端口'));
  

  注意：存储用户密码时，必须用bcrypt.hash()生成哈希值，禁止明文存储。

3. Flutter端获取Token并完成登录 #

在Flutter项目中调用后端接口拿到自定义Token，再通过Firebase Auth完成登录：

• 引入依赖：在pubspec.yaml中添加firebase_auth和http
• 编写登录逻辑：

  import 'package:firebase_auth/firebase_auth.dart';
  import 'package:http/http.dart' as http;
  import 'dart:convert';
  
  Future<void> loginWithUsername(String username, String password) async {
    try {
      // 调用后端验证接口
      final response = await http.post(
        Uri.parse('http://your-backend-url:3000/verify-login'),
        headers: {'Content-Type': 'application/json'},
        body: jsonEncode({'username': username, 'password': password}),
      );
  
      if (response.statusCode == 200) {
        final token = jsonDecode(response.body)['token'];
        // 使用自定义Token登录Firebase
        await FirebaseAuth.instance.signInWithCustomToken(token);
        // 登录成功后可获取用户信息
        final currentUser = FirebaseAuth.instance.currentUser;
        print('登录成功，用户UID：${currentUser?.uid}');
      } else {
        throw Exception(jsonDecode(response.body)['error']);
      }
    } catch (e) {
      print('登录失败：$e');
    }
  }
  

额外注意事项 #

• 后端接口必须启用HTTPS，防止凭证在传输过程中泄露
• 可给后端接口添加限流、验证码等防护，避免暴力破解
• 首次登录时，Firebase Auth会自动创建对应用户记录，若需补充用户信息（如用户名），可登录后调用currentUser?.updateProfile(displayName: username)
• 若需给用户添加角色权限，生成Token时可传入自定义声明：

  const customToken = await admin.auth().createCustomToken(uid, { role: 'admin' });
  

  在Flutter中可通过currentUser?.getIdTokenResult()获取这些声明

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