如何在Firebase Functions及Android应用中触发用户启用/禁用事件

我来帮你详细说明在Firebase Functions云函数和Android应用里触发用户账户启用/禁用事件的具体方法，分两部分来拆解：

云函数主要有两种使用场景：一种是自动监听用户状态变更触发逻辑，另一种是主动调用函数修改用户状态。

1. 监听用户启用/禁用的自动触发事件 #

当你在Firebase Auth控制台手动修改用户启用/禁用状态时，Auth会触发用户更新事件，我们可以用onUpdate触发器来监听并执行自定义逻辑：

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

exports.onUserStatusChanged = functions.auth.user().onUpdate(async (change, context) => {
  const userBefore = change.before;
  const userAfter = change.after;

  // 对比前后状态，判断是启用还是禁用操作
  const wasDisabled = !userBefore.disabled;
  const isDisabled = userAfter.disabled;

  if (wasDisabled !== isDisabled) {
    const statusDesc = isDisabled ? "禁用" : "启用";
    functions.logger.info(`用户 ${userAfter.uid} 已被${statusDesc}`);
    
    // 这里可以添加自定义业务逻辑，比如同步状态到数据库、发送通知等
    await admin.firestore().collection("users").doc(userAfter.uid).update({
      isDisabled: isDisabled,
      updatedAt: admin.firestore.FieldValue.serverTimestamp()
    });
  }

  return null;
});

2. 主动调用云函数修改用户状态（适合后台/管理员操作） #

如果需要通过API主动触发用户状态变更，可以写一个Callable云函数，供前端或其他服务调用：

exports.toggleUserStatus = functions.https.onCall(async (data, context) => {
  // 先验证调用者权限，比如只有管理员能执行此操作
  if (!context.auth || !context.auth.token.admin) {
    throw new functions.https.HttpsError("permission-denied", "只有管理员可以修改用户状态");
  }

  const { uid, disable } = data;
  if (!uid || disable === undefined) {
    throw new functions.https.HttpsError("invalid-argument", "缺少必要参数：uid 和 disable");
  }

  try {
    // 调用Auth API修改用户禁用状态
    await admin.auth().updateUser(uid, {
      disabled: disable
    });

    return {
      success: true,
      message: `用户 ${uid} 已被${disable ? "禁用" : "启用"}`
    };
  } catch (error) {
    throw new functions.https.HttpsError("internal", error.message);
  }
});

注：调用此函数的用户需要在自定义Claims中设置admin: true，否则会返回权限错误。

Android端主要涉及两种操作：管理员端调用云函数修改用户状态，以及普通用户端监听自身账户状态变化。

1. 管理员端调用Callable云函数修改用户状态 #

确保应用已集成Firebase Functions，然后调用上面定义的toggleUserStatus函数：

// 获取Functions实例
val functions = FirebaseFunctions.getInstance()

// 准备请求参数
val requestData = hashMapOf(
    "uid" to "目标用户的UID",
    "disable" to true // true=禁用，false=启用
)

// 发起函数调用
functions.getHttpsCallable("toggleUserStatus")
    .call(requestData)
    .addOnSuccessListener { result ->
        val response = result.data as Map<*, *>
        val message = response["message"] as String
        Toast.makeText(this, message, Toast.LENGTH_SHORT).show()
    }
    .addOnFailureListener { exception ->
        if (exception is FirebaseFunctionsException) {
            val errorDetails = exception.details
            Toast.makeText(this, "操作失败：$errorDetails", Toast.LENGTH_SHORT).show()
        } else {
            Toast.makeText(this, exception.message, Toast.LENGTH_SHORT).show()
        }
    }

2. 普通用户端监听账户状态变化 #

当用户账户被禁用后，下次登录会失败，应用需要捕获这个错误并提示用户；同时也可以实时监听当前用户的状态变化：

// 登录时处理禁用错误
FirebaseAuth.getInstance().signInWithEmailAndPassword(email, password)
    .addOnCompleteListener(this) { task ->
        if (task.isSuccessful) {
            // 登录成功，正常进入应用
        } else {
            val exception = task.exception
            if (exception is FirebaseAuthInvalidUserException) {
                when (exception.errorCode) {
                    "ERROR_USER_DISABLED" -> {
                        Toast.makeText(this, "你的账户已被禁用，请联系管理员", Toast.LENGTH_LONG).show()
                    }
                    else -> {
                        Toast.makeText(this, exception.message, Toast.LENGTH_SHORT).show()
                    }
                }
            } else {
                Toast.makeText(this, exception?.message, Toast.LENGTH_SHORT).show()
            }
        }
    }

// 实时监听当前用户状态变化
FirebaseAuth.getInstance().addAuthStateListener { auth ->
    val currentUser = auth.currentUser
    currentUser?.let { user ->
        // 重新加载用户信息，获取最新状态（本地缓存可能不实时）
        user.reload().addOnCompleteListener { reloadTask ->
            if (reloadTask.isSuccessful && user.isDisabled) {
                // 账户已被禁用，退出登录并提示
                FirebaseAuth.getInstance().signOut()
                Toast.makeText(this, "账户已被禁用", Toast.LENGTH_LONG).show()
            }
        }
    }
}

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