Supabase Auth Facebook登录报错：无法获取外部提供商用户邮箱

核心问题分析 #

这个错误直接指向Supabase无法从Facebook获取用户邮箱信息——即便你已配置email权限，大概率是权限未实际生效、Facebook应用设置有遗漏，或是Supabase侧的配置细节出错。

具体排查与解决步骤 #

1. 确认Facebook应用权限是否真的生效 #

• 进入Facebook开发者后台，找到目标应用 → 应用审核 → 权限与功能，检查email和public_profile的状态：正式环境需为「已上线」，测试环境要确保测试用户已添加到应用的测试用户列表，且该测试用户的隐私设置允许邮箱被第三方应用获取。
• 手动验证权限：用测试用户的access_token请求https://graph.facebook.com/me?fields=email,name，如果返回结果里没有邮箱，说明权限配置未到位，测试环境重新确认测试用户添加状态，正式环境重新提交权限审核。

2. 核对Supabase的OAuth配置细节 #

登录Supabase控制台，进入项目 → Authentication → Providers → Facebook，检查：

• 应用ID和密钥完全匹配Facebook后台信息，无多余空格或字符。
• 回调URL和Facebook后台产品→Facebook登录→设置里的「有效的OAuth重定向URI」完全一致，包括协议（http/https）、域名、端口，比如本地环境通常是http://localhost:3000/auth/callback，要和项目实际地址对应。

3. 显式声明OAuth请求的权限范围 #

默认情况下Supabase的signInWithOAuth可能未明确请求邮箱权限，手动添加scopes参数强制声明：

const supabase = useSupabaseAuthClient();
const socialAuth = async (provider) => {
  const { error } = await supabase.auth.signInWithOAuth({
    provider: provider,
    options: {
      scopes: 'email,public_profile'
    }
  });
  if (error) {
    console.log(error);
  } else {
    console.log("Social Auth success.");
  }
};

4. 补全Facebook应用的隐私政策配置 #

Facebook要求应用必须填写隐私政策URL（测试环境也需满足），否则会限制用户数据获取。进入Facebook后台设置→基本，填写隐私政策URL（可临时用GitHub Gist链接），保存后重试。

5. 检查Nuxt项目的Supabase全局配置 #

确保nuxt.config.ts里的Supabase配置正确，重点核对回调地址：

export default defineNuxtConfig({
  modules: ['@nuxtjs/supabase'],
  supabase: {
    url: process.env.SUPABASE_URL,
    key: process.env.SUPABASE_ANON_KEY,
    redirectOptions: {
      login: '/login',
      callback: '/auth/callback', // 必须和Facebook后台的回调URL完全一致
      exclude: []
    }
  }
});

额外验证动作 #

• 清除浏览器缓存和Facebook登录状态，用隐身模式重新测试，避免旧权限缓存干扰。
• 查看Supabase的Authentication→Logs，里面会有更具体的失败细节（比如Facebook返回的错误码），帮助定位问题。

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