PHP创建用户认证时重复信息等错误的处理方案咨询

1. 捕获Firebase异常（核心解决步骤） #

Firebase Admin SDK在创建用户遇到重复邮箱、手机号等冲突时会抛出特定认证异常，直接捕获并处理这些异常就能避免应用崩溃，同时返回明确的错误提示。

修改代码如下：

$userProperties = [
    'email' => $data["Email"],
    'emailVerified' => false,
    'password' => $data["Password"],
    'displayName' => $data["Name"],
    'photoUrl' => '',
    'disabled' => false,
    "uid" => $uid
];

try {
    $createdUser = self::$auth->createUser($userProperties);
    // 创建成功后的逻辑，比如返回用户信息
    return ['status' => 'success', 'user' => $createdUser];
} catch (\Kreait\Firebase\Exception\Auth\EmailExists $e) {
    // 处理邮箱已存在的情况
    return ['status' => 'error', 'message' => '该邮箱已被注册'];
} catch (\Kreait\Firebase\Exception\Auth\PhoneNumberExists $e) {
    // 处理手机号已存在的情况
    return ['status' => 'error', 'message' => '该手机号已被注册'];
} catch (\Kreait\Firebase\Exception\AuthException $e) {
    // 处理其他认证相关错误
    return ['status' => 'error', 'message' => '用户创建失败：' . $e->getMessage()];
} catch (\Exception $e) {
    // 兜底处理其他未知错误
    return ['status' => 'error', 'message' => '系统异常，请稍后重试'];
}

2. 提前校验（可选优化） #

如果想在调用createUser前提前拦截冲突，可以用getUserByEmail或getUserByPhoneNumber方法预先检查：

// 提前检查邮箱
try {
    self::$auth->getUserByEmail($data["Email"]);
    return ['status' => 'error', 'message' => '该邮箱已被注册'];
} catch (\Kreait\Firebase\Exception\Auth\UserNotFound $e) {
    // 邮箱不存在，继续执行创建逻辑
}

// 提前检查手机号（若用户属性包含phoneNumber）
if (isset($data["PhoneNumber"])) {
    try {
        self::$auth->getUserByPhoneNumber($data["PhoneNumber"]);
        return ['status' => 'error', 'message' => '该手机号已被注册'];
    } catch (\Kreait\Firebase\Exception\Auth\UserNotFound $e) {
        // 手机号不存在，继续执行创建逻辑
    }
}

// 执行创建用户逻辑
try {
    $createdUser = self::$auth->createUser($userProperties);
    return ['status' => 'success', 'user' => $createdUser];
} catch (\Exception $e) {
    return ['status' => 'error', 'message' => '用户创建失败：' . $e->getMessage()];
}

注意：提前校验无法完全替代异常捕获——校验和创建之间可能存在并发请求导致的竞态条件，所以异常捕获仍是必须的兜底手段。

3. 错误信息标准化 #

统一返回结构化的错误响应，比如始终返回包含status（success/error）和message字段的数组，避免直接将异常抛到应用上层，方便前端或调用方处理。

内容的提问来源于stack exchange，提问作者Abdel Rahman Yosry