Firebase Admin Java SDK 自定义认证与实时数据库快速上手

Firebase Admin Java SDK 是一款能让开发者在 Java 环境中便捷访问 Firebase 服务的工具包，本安装教程将为新手入门提供详尽的配置指南，助你快速掌握在服务器或云环境中用 Java 与 Firebase 交互的方法。

一、项目概述：认识 Firebase Admin Java SDK

💡 实用提示：在开始安装配置前，先简单了解项目功能，能帮你更清晰地理解后续操作的意义哦。

Firebase Admin Java SDK 是开源项目，主要功能是让开发者在 Java 环境下与 Firebase 服务进行交互，像 Firebase 自定义认证（通过代码生成和验证用户身份令牌）和实时数据库（能实时存储和同步数据）都能支持。它的主要编程语言是 Java，所以需要你对 Java 基础有一定了解。

二、零基础环境部署：准备必要工具

💡 实用提示：环境准备是后续操作的基础，一定要确保每个工具都安装正确，不然可能会影响项目运行。

要使用 Firebase Admin Java SDK，得先准备好 Java 开发环境和依赖管理工具。依赖管理就是管理项目所需的第三方工具包，这里我们用 Maven 来进行。

如何检查 Java 是否安装？

打开终端，输入以下命令：

java -version

如果显示 Java 8 及以上版本信息，就说明 Java 已安装。如果没安装，去 Java 官网下载并安装 Java 8 或更高版本，建议用 Java 11 或 Java 17。

如何检查 Maven 是否安装？

同样在终端输入：

mvn -version

若能看到 Maven 版本信息，即表示安装成功。若未安装，前往 Maven 官网下载并安装。

如何创建 Firebase 项目？

1. 打开 Firebase 控制台，登录你的 Google 账号。
2. 点击“添加项目”，按照提示填写项目名称等信息，完成项目创建。
3. 创建完成后，在项目设置里下载配置文件 google-services.json，这个文件很重要，后面配置会用到。

三、三步完成配置：从获取项目到初始化 SDK

💡 实用提示：这部分是核心操作，每一步都要仔细哦，建议操作时对照步骤逐步进行。

第一步：获取项目代码

因为项目需要从指定仓库克隆，所以在终端中执行以下命令：

git clone https://gitcode.com/gh_mirrors/fi/firebase-admin-java

这个命令会把项目代码下载到本地。

第二步：添加依赖

进入项目目录，找到 pom.xml 文件，在 <dependencies> 标签内添加 Firebase Admin SDK 的依赖：

<dependency>
    <groupId>com.google.firebase</groupId>
    <artifactId>firebase-admin</artifactId>
    <version>最新版本</version>
</dependency>

你可以通过 Maven 中央仓库查询获取最新版本号，将“最新版本”替换掉。

第三步：初始化 Firebase Admin SDK

把之前下载的 google-services.json 文件放到项目的 src/main/resources 目录下。然后创建一个 Java 类，比如 FirebaseInitializer，在其中编写初始化代码：

import com.google.auth.oauth2.GoogleCredentials;
import com.google.firebase.FirebaseApp;
import com.google.firebase.FirebaseOptions;

import java.io.FileInputStream;
import java.io.IOException;

public class FirebaseInitializer {
    public static void main(String[] args) throws IOException {
        // 读取配置文件
        FileInputStream serviceAccount = new FileInputStream("src/main/resources/google-services.json");

        // 设置 Firebase 选项
        FirebaseOptions options = new FirebaseOptions.Builder()
                .setCredentials(GoogleCredentials.fromStream(serviceAccount))
                .setDatabaseUrl("https://<your-database-name>.firebaseio.com") // 替换成你的数据库 URL
                .build();

        // 初始化 Firebase App
        FirebaseApp.initializeApp(options);
        System.out.println("Firebase Admin SDK 初始化成功！");
    }
}

这段代码的作用是读取配置文件，设置 Firebase 连接参数，然后完成 SDK 的初始化。

四、验证测试：确保配置正确

💡 实用提示：验证测试能帮你确认之前的配置是否成功，及时发现问题。

如何编译并运行项目？

在项目根目录下，打开终端，执行以下命令编译项目：

mvn clean install

编译成功后，运行初始化类：

mvn exec:java -Dexec.mainClass="com.google.firebase.FirebaseInitializer"

如果终端输出“Firebase Admin SDK 初始化成功！”，说明配置正确。

五、常见问题排查

⚠️ 注意：遇到问题先不要慌，看看下面的常见问题有没有你遇到的情况。

Q：执行 mvn clean install 时报依赖相关错误怎么办？

A：检查 pom.xml 中 Firebase Admin SDK 的依赖是否正确，版本号是否存在。可以尝试删除 ~/.m2/repository 目录下的相关依赖，然后重新执行命令下载依赖。

Q：初始化 SDK 时提示找不到 google-services.json 文件？

A：确认 google-services.json 文件是否放在了 src/main/resources 目录下，文件名是否正确，路径是否有误。

Q：运行项目时出现数据库连接错误？

A：检查 setDatabaseUrl 方法中的 URL 是否正确，确保 Firebase 项目中实时数据库已启用，并且网络连接正常。

Q：Java 版本不兼容怎么办？

A：确认安装的 Java 版本是 8 及以上，如果版本过低，升级 Java 版本后重新尝试。

Q：Maven 命令无法识别？

A：检查 Maven 是否正确安装，环境变量是否配置。可以重新安装 Maven 并配置好环境变量后再试。