如何发送Firebase无密码登录链接？请求200成功未收到邮件

已确认前置条件 #

• 已在Firebase控制台启用邮箱登录（魔术链接）功能
• 已将localhost添加至授权域名列表
• 接口调用返回200成功状态码，代码运行全程无报错，但目标邮箱始终未收到登录邮件

相关实现代码 #

魔术链接发送方法 #

export const sendMagicLink = (email: string, redirectUrl: string) => {
const auth = getAuth(getClientApp());
const actionCodeSettings = {
    url: redirectUrl,
    handleCodeInApp: true
};
return sendSignInLinkToEmail(auth, email, actionCodeSettings);};

表单提交处理逻辑 #

const handleSubmit: svelte.JSX.EventHandler<SubmitEvent, HTMLFormElement> = async ({
        currentTarget
    }) => {
        email = new FormData(currentTarget).get('email') as string;
        const redirectUrl = `${window.location.origin}/auth/confirm`;
        state = 'submitting';

        try {
            await sendMagicLink(email, redirectUrl);
            setMagicEmail(email);
            state = 'success';
        } catch (error) {
            if (error instanceof Error) {
                state = error;
            } else {
                console.log(error);
                state = new Error('something went wrong sending the magic link 😞');
            }
        }
    };

实际请求参数 #

canHandleCodeInApp  true
continueUrl "http://localhost:3000/auth/confirm"
email   "someemail@gmail.com"
requestType "EMAIL_SIGNIN"

问题截图 #

排查方向与解决方案 #

• 邮箱侧拦截/归类问题：优先检查目标邮箱的垃圾邮件、促销邮件、所有邮件文件夹，Gmail等服务商常把自动认证邮件归类到非收件箱目录；如果是企业域名邮箱，需确认企业邮件网关没有拦截Firebase的发件地址。
• 邮件模板配置问题：进入Firebase控制台「Authentication > 模板 > 电子邮件模板」页面，若配置了自定义发件域名，需确认该域名已经完成SPF、DKIM记录验证，未完成验证的自定义发件域会导致投递静默失败；未配置自定义域名时先切回默认的noreply@[项目id].firebaseapp.com发件地址测试。
• 频率/配额限制问题：Firebase对同个邮箱短时间内的发信请求有频率限制，免费版项目也有月度发信配额上限，触发限流或配额耗尽时接口仍返回200但不会发信，换一个未测试过的新邮箱重试即可快速验证。
• 登录范围限制问题：进入Firebase控制台「Authentication > 设置 > 用户操作」页面，检查是否开启了「禁止新建用户」开关，开启后不在已有用户列表内的邮箱请求魔术链接会被静默丢弃，不会发信。
• 本地网络代理问题：如果本地开启了全局网络代理，部分代理规则会篡改请求上下文导致Firebase侧判定请求异常，关闭代理直连网络重试即可排除该问题。

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