AngularFire报错：User类型不存在setCustomUserClaims属性

首先明确：setCustomUserClaims() 是Firebase Admin SDK的方法，不是客户端Auth模块中User对象的方法——你在前端Angular代码里直接调用肯定会报错，这个方法只能在可信环境（比如Firebase Cloud Functions、你的后端服务器、本地Admin脚本）中执行，因为它需要管理员权限，前端直接调用会带来严重安全风险。

以下是具体解决步骤：

推荐实现方式：通过Firebase Cloud Functions #

1. 编写Cloud Functions（后端逻辑） #

在你的Firebase项目中创建一个Callable Function，用来处理设置自定义声明的请求：

// functions/src/index.ts
import * as functions from "firebase-functions";
import * as admin from "firebase-admin";

admin.initializeApp();

export const setCustomUserClaims = functions.https.onCall(async (data, context) => {
  // 可选：验证调用者是否有管理员权限，避免任意用户修改权限
  if (!context.auth?.token.admin) {
    throw new functions.https.HttpsError("permission-denied", "仅管理员可设置用户权限");
  }

  const { uid, claims } = data;
  if (!uid || !claims) {
    throw new functions.https.HttpsError("invalid-argument", "需提供用户UID和权限声明");
  }

  try {
    await admin.auth().setCustomUserClaims(uid, claims);
    return { success: true, message: "权限声明设置成功" };
  } catch (error) {
    throw new functions.https.HttpsError("internal", "设置权限声明失败", error);
  }
});

部署该函数到Firebase：

firebase deploy --only functions

2. 前端Angular代码调用该函数 #

修改你的AuthService，通过Callable Function触发权限设置：

import { inject, Injectable, OnDestroy } from '@angular/core';
import { Auth, user } from '@angular/fire/auth';
import { Functions, httpsCallable } from '@angular/fire/functions';
import { Subscription } from 'rxjs';

@Injectable({
  providedIn: 'root'
})
export class AuthService implements OnDestroy {
  private auth: Auth = inject(Auth);
  private functions: Functions = inject(Functions);
  user$ = user(this.auth);
  userSubscription: Subscription;

  constructor() {
    this.userSubscription = this.user$.subscribe(async (aUser) => {
      if (aUser) {
        // 注意：示例仅作演示，实际场景不要在用户登录时自动设管理员权限
        // 应在专属管理员操作界面触发此调用
        const setClaims = httpsCallable(this.functions, 'setCustomUserClaims');
        try {
          await setClaims({ uid: aUser.uid, claims: { admin: true } });
          console.log("权限声明已更新");
        } catch (error) {
          console.error("设置权限失败:", error);
        }
      }
    });
  }

  ngOnDestroy() {
    this.userSubscription.unsubscribe();
  }
}

其他可选方案 #

如果你有自建后端服务器，可在后端集成Firebase Admin SDK：

1. 在后端初始化Firebase Admin SDK（需配置服务账号密钥）
2. 编写API接口接收用户UID和权限声明，调用admin.auth().setCustomUserClaims(uid, claims)
3. 前端通过HTTP请求调用该后端接口

关键注意事项 #

• 绝对不要在前端直接使用Firebase Admin SDK，会泄露管理员私钥引发安全问题
• 设置自定义声明后，用户需重新登录或调用user.getIdToken(true)强制刷新令牌，才能获取更新后的声明
• 可通过user.getIdTokenResult()获取用户自定义声明，用于前端权限判断

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