如何使用 Go 语言通过 Firebase Admin SDK 创建认证用户-Golang-PHP中文网

如何使用 Go 语言通过 Firebase Admin SDK 创建认证用户

本文介绍如何在 go 应用中集成 firebase admin sdk，安全、可靠地创建和管理 firebase authentication 用户，支持自定义 uid、邮箱、密码、手机号等字段，并提供完整代码示例与关键注意事项。

本文介绍如何在 go 应用中集成 firebase admin sdk，安全、可靠地创建和管理 firebase authentication 用户，支持自定义 uid、邮箱、密码、手机号等字段，并提供完整代码示例与关键注意事项。

Firebase 官方现已正式支持 Go 语言，通过 Firebase Admin SDK for Go 可直接在服务端安全地管理用户身份（Authentication），无需暴露敏感凭证到前端。这与客户端 JavaScript 的 createUserWithEmailAndPassword() 有本质区别：Go SDK 运行于可信服务端环境，可执行高权限操作（如设置 UID、跳过邮箱验证、禁用账户等），且不依赖用户输入密码的明文传输。

✅ 基础准备

启用 Firebase Admin SDK
在 Firebase 控制台 → 项目设置 → 服务账号 → 生成新的私钥（JSON 文件），并妥善保管（切勿提交至 Git）。

安装依赖

go get firebase.google.com/go
go get cloud.google.com/go/firestore

初始化客户端（推荐使用环境变量加载凭据）

import (
    "context"
    "log"
    "os"
    "firebase.google.com/go"
    "google.golang.org/api/option"
    "firebase.google.com/go/auth"
)

func initAuthClient() (*auth.Client, error) {
    ctx := context.Background()
    // 方式一：通过环境变量 GOOGLE_APPLICATION_CREDENTIALS 指定 JSON 密钥路径
    opt := option.WithCredentialsFile(os.Getenv("FIREBASE_CREDENTIALS_PATH"))
    conf, err := firebase.NewConfig(ctx, nil, opt)
    if err != nil {
        return nil, err
    }
    client, err := conf.Auth(ctx)
    if err != nil {
        return nil, err
    }
    return client, nil
}

✅ 创建用户（标准方式）

以下示例创建一个完整用户，包含邮箱、密码、显示名、头像、手机号及邮箱验证状态：

client, err := initAuthClient()
if err != nil {
    log.Fatalf("初始化 Auth 客户端失败: %v", err)
}

params := (&auth.UserToCreate{}).
    Email("user@example.com").
    EmailVerified(false).
    PhoneNumber("+8613800138000").
    Password("Secure@2024!").
    DisplayName("张三").
    PhotoURL("https://example.com/avatar.jpg").
    Disabled(false)

user, err := client.CreateUser(context.Background(), params)
if err != nil {
    log.Fatalf("创建用户失败: %v", err)
}
log.Printf("用户创建成功，UID: %s, 邮箱: %s", user.UID, user.Email)

⚠️ 注意：Password 字段仅在创建时生效，Firebase 会自动哈希存储；后续修改密码需调用 UpdateUser 并传入新密码。

✅ 创建用户（指定自定义 UID）

若需将 Firebase UID 与业务系统 ID 绑定（如数据库主键、OAuth 子 ID），可显式设置 UID：

params := (&auth.UserToCreate{}).
    UID("usr_123456789"). // 必须唯一、长度 1–128 字符，仅含字母、数字、下划线、短横线
    Email("custom@example.com").
    Password("P@ssw0rd")

user, err := client.CreateUser(context.Background(), params)
if err != nil {
    log.Fatalf("创建自定义 UID 用户失败: %v", err)
}
log.Printf("自定义 UID 用户已创建: %s", user.UID)

✅ 优势：避免额外映射表，简化跨系统用户关联逻辑；⚠️ 风险：UID 不可更改，务必确保业务层生成逻辑幂等且唯一。

✅ 更新用户信息

支持动态更新邮箱、密码、头像、禁用状态等（无需重新输入原始密码）：

updateParams := (&auth.UserToUpdate{}).
    EmailVerified(true).
    DisplayName("张三（已认证）").
    PhotoURL("https://example.com/new-avatar.jpg").
    Disabled(false)

updatedUser, err := client.UpdateUser(context.Background(), "usr_123456789", updateParams)
if err != nil {
    log.Fatalf("更新用户失败: %v", err)
}
log.Printf("用户信息更新成功: %+v", updatedUser)

? 关键注意事项

? 绝不使用前端或不可信环境调用 Admin SDK：该 SDK 拥有最高权限，必须部署在受控后端（如 Cloud Functions、GCP VM、K8s 服务）。
? 网络要求：服务端需能访问 firebase.googleapis.com（国内需配置合规代理或使用 GCP 中国区镜像）。
? 邮箱验证需配合 SMTP 或 Firebase 动态链接：Admin SDK 仅设置 EmailVerified 标志位，真实验证流程仍需前端调用 sendEmailVerification() 或后端发送自定义邮件。
? 错误处理建议：捕获常见错误如 auth.ErrUserNotFound、auth.ErrEmailAlreadyExists、auth.ErrInvalidPassword，返回用户友好的提示而非原始错误。
? 替代方案说明：firego 是第三方非官方库，已停止维护且不支持 Firebase Authentication v2 API；强烈推荐迁移到官方 Admin SDK。

通过以上方式，你可以在 Go 项目中构建健壮、可扩展的 Firebase 用户管理体系，兼顾安全性与开发效率。