Android应用集成Firebase Admin SDK与Firebase Auth的冲突问题

核心问题：Firebase Admin SDK不能在Android客户端使用 #

Firebase Admin SDK是为服务器端/后端环境设计的，它需要服务账户密钥来获得最高权限，直接在Android客户端集成会导致密钥泄露，引发严重安全问题。你遇到的依赖冲突、getUsers方法无法识别，本质是客户端的Firebase Auth SDK和Admin SDK的FirebaseAuth类是完全不同的实现，二者不能在客户端混用。

正确解决方案 #

1. 清理客户端依赖 #

移除Android项目build.gradle里的Admin SDK依赖，只保留客户端Firebase Auth及其他必要依赖，通过Firebase BOM统一管理版本：

dependencies {
    implementation platform('com.google.firebase:firebase-bom:32.8.0')
    implementation 'com.google.firebase:firebase-auth' // 由BOM自动管理版本，无需指定具体号
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.11.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
    implementation 'androidx.legacy:legacy-support-v4:1.0.0'
    implementation 'androidx.lifecycle:lifecycle-livedata-ktx:2.6.1'
    implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.6.1'
    implementation 'androidx.recyclerview:recyclerview:1.3.2'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
}

这样客户端就能正常使用FirebaseUser和普通Auth登录功能。

2. 通过Cloud Functions实现用户列表获取 #

在Firebase Cloud Functions中用Admin SDK编写获取用户列表的接口，客户端调用该接口完成需求：

编写Cloud Functions（Node.js示例）

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

exports.getAllUsers = functions.https.onCall(async (data, context) => {
    // 验证调用者是管理员（通过自定义声明或邮箱判断）
    if (!context.auth || !context.auth.token.admin) {
        throw new functions.https.HttpsError('permission-denied', '只有管理员可以访问');
    }

    try {
        const users = [];
        let nextPageToken;
        do {
            const listUsersResult = await admin.auth().listUsers(1000, nextPageToken);
            users.push(...listUsersResult.users);
            nextPageToken = listUsersResult.pageToken;
        } while (nextPageToken);

        // 返回用户必要信息，避免泄露敏感数据
        return users.map(user => ({
            uid: user.uid,
            email: user.email,
            displayName: user.displayName,
            photoURL: user.photoURL
        }));
    } catch (error) {
        throw new functions.https.HttpsError('internal', '获取用户列表失败', error);
    }
});

客户端调用Cloud Functions

先添加Cloud Functions依赖：

implementation 'com.google.firebase:firebase-functions'

再编写调用代码：

// 初始化Functions实例
FirebaseFunctions functions = FirebaseFunctions.getInstance();

// 调用getAllUsers函数
Map<String, Object> data = new HashMap<>();
functions.getHttpsCallable("getAllUsers")
        .call(data)
        .addOnSuccessListener(result -> {
            List<Map<String, Object>> users = (List<Map<String, Object>>) result.getData();
            // 处理获取到的用户列表数据
        })
        .addOnFailureListener(e -> {
            // 处理调用失败逻辑
        });

3. 管理员权限验证 #

在Firebase控制台或通过Admin SDK给管理员账号设置自定义声明，确保只有管理员能调用获取用户列表的接口，避免权限滥用。

为何之前的代码无法工作 #

• 客户端的FirebaseAuth来自com.google.firebase:firebase-auth，没有getUsers方法，该方法是Admin SDK中com.google.firebase.auth.FirebaseAuth（包名不同）的专属方法。
• 同时引入两个SDK会触发类路径冲突，客户端SDK会覆盖Admin SDK的类，导致IDE无法识别Admin的方法。

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