Firebase Auth调用createUserWithEmailAndPassword返回undefined如何排查

可能的问题原因 #

• 不必要的await误用：代码中对new_user_dict['email']、new_user_dict['password']、error.code这类普通同步值额外添加了await关键字，虽然不会直接触发报错，但如果对应变量存在未初始化、值为空的情况，多余的await会返回不符合预期的结果，甚至干扰异步逻辑的执行顺序。
• Firebase Auth实例初始化异常：Firebase初始化逻辑是高风险点，包括但不限于近期更新了Firebase SDK版本、API密钥过期、项目配置被修改、当前访问域名未加入Firebase控制台的授权域名列表，都会导致firebase.auth()调用返回undefined或无效实例，进而调用createUserWithEmailAndPassword后直接返回undefined。
• new_user_dict变量未正确初始化：如果该全局变量没有提前声明为对象，在赋值email、password属性时会抛出引用错误，导致后续逻辑中断，无正常返回值。
• 异步逻辑未捕获异常：newUserSubmitEmailAndPassword是async函数，调用时未添加await关键字、也未做外层异常捕获，哪怕内部逻辑抛出异常也无法被捕获，最终只会返回undefined。

排查步骤 #

1. 打开浏览器开发者工具的控制台，查看调用创建用户接口时的报错信息，优先确认是否存在firebase.auth is not a function、Cannot read property 'createUserWithEmailAndPassword' of undefined这类提示，排查Firebase实例是否正常初始化。
2. 在firebase.auth().createUserWithEmailAndPassword调用前添加打印代码console.log(firebase.auth(), new_user_dict)，确认auth实例存在，且new_user_dict中的email、password都是非空的合法字符串。
3. 检查Firebase控制台的Authentication设置，确认「电子邮件/密码」登录提供程序已开启，当前访问域名已添加到「授权域名」列表，近期未修改过项目安全规则或API密钥权限。

修复方案 #

首先修正代码中不合理的await用法，统一异步逻辑写法，避免混用then/catch和await导致逻辑混乱：

// 提前初始化全局变量，避免引用错误
const new_user_dict = {};

async function newUserSubmitEmailAndPassword() {
    traceFunction()
    console.log('newUserSubmitEmailAndPassword email is ', new_user_dict['email'], ' password is ', new_user_dict['password'])
    input_text.value = ''
    try {
        // 仅对异步的createUser方法添加await，去掉普通值前的多余await
        const userCredential = await firebase.auth().createUserWithEmailAndPassword(new_user_dict['email'], new_user_dict['password'])
        console.log('newUserSubmitEmailAndPassword User created successfully')
        userCreatedSuccessfully()
    } catch (error) {
        // error.code是同步属性，不需要加await
        const errorCode = error.code
        const errorMessage = error.message
        question.innerText = errorCode
        console.log('newUserSubmitEmailAndPassword Error creating user. Error code: ', errorCode, ' ', errorMessage)
        if (errorCode === 'auth/email-already-in-use') {
            newUserEmailInUse()
        } else if (errorCode === 'auth/invalid-email') {
            newUserTryEmailAgain()
        } else if (errorCode === 'auth/operation-not-allowed') {
            errorPleaseRefresh()
        } else if (errorCode === 'auth/weak-password') {
            newUserTryPasswordAgain()
        }
    }
}

如果修正代码后问题依旧存在，优先排查Firebase初始化逻辑：确认导入的SDK版本和语法匹配（当前代码用的是Firebase v8版本的API，如果误导入v9及以上版本的SDK会直接报错）、初始化配置的apiKey、authDomain等参数和Firebase控制台完全一致。

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