如何在supabase.auth.currentUser中添加用户名信息？

要让supabase.auth.currentUser包含用户名，核心是利用Supabase的**用户元数据（user_metadata）**功能，以下是具体实现方式：

1. 更新现有用户的元数据（添加/修改用户名） #

如果用户已经完成注册，你可以通过updateUser方法向用户的元数据中添加用户名字段，之后currentUser就会包含该信息：

// 登录后执行此代码
const { data, error } = await supabase.auth.updateUser({
  data: {
    username: 'your-custom-username' // 替换为实际用户名
  }
})

if (error) {
  console.error('更新用户元数据失败:', error)
} else {
  // 更新成功后，currentUser会自动同步最新数据
  const currentUser = supabase.auth.currentUser
  console.log('用户名:', currentUser.user_metadata.username)
}

2. 注册时直接设置用户名 #

对于新用户，注册时可以直接在options.data中传入用户名，这样用户创建完成后，currentUser里就会自带该字段：

const { data, error } = await supabase.auth.signUp({
  email: 'user@example.com',
  password: 'secure-password',
  options: {
    data: {
      username: 'new-user-username'
    }
  }
})

if (!error) {
  const newUser = data.user
  console.log('新用户用户名:', newUser.user_metadata.username)
}

3. 封装函数让用户名直接出现在顶层（可选） #

Supabase的currentUser顶层字段是固定的（如id、email、full_name），自定义字段默认存在user_metadata下。如果想让用户名像内置字段一样直接在顶层访问，可以封装一个工具函数：

function getCurrentUserWithUsername() {
  const user = supabase.auth.currentUser
  if (!user) return null
  
  // 将user_metadata中的username提取到顶层
  return {
    ...user,
    username: user.user_metadata?.username
  }
}

// 使用示例
const user = getCurrentUserWithUsername()
if (user) {
  console.log('顶层用户名:', user.username)
}

注意事项 #

• 更新元数据后，supabase.auth.currentUser会自动同步最新状态，无需手动刷新；若不确定，可调用supabase.auth.getUser()获取绝对最新的用户数据。
• 用户元数据支持存储任意自定义键值对，除了用户名，还可以添加其他你需要的字段。

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