如何在Firebase Authentication中设置自定义UID以实现用户名式个人主页URL

Firebase Authentication 默认不允许在创建用户时直接自定义 UID（beforeCreate 触发器确实无法修改UID），但可以通过以下方案实现你要的 my-project.com/username 访问逻辑，甚至可以用用户名作为UID：

方案一：不修改UID，通过映射实现路由（推荐） #

这是更符合Firebase设计的方案，避免修改UID带来的潜在问题：

• 用户注册时，收集邮箱、密码和用户名，先通过云函数或前端校验用户名是否唯一（比如在Firestore创建一个usernames集合，用用户名作为文档ID，创建时如果文档已存在则提示用户名已被占用）
• 用户注册成功后，将用户名 -> UID的映射存储到Firestore/Realtime Database，同时在用户资料集合（比如users）中存储用户名
• 当访问my-project.com/username时，先查询usernames集合找到对应的UID，再用UID获取完整的用户资料

方案二：用自定义令牌创建以用户名作为UID的用户 #

如果一定要把用户名设为UID，可以通过Firebase Admin SDK生成自定义令牌实现：

• 前端收集用户注册信息（邮箱、密码、用户名），提交到云函数
• 云函数中先校验用户名唯一性（同样用数据库原子操作避免并发冲突）
• 校验通过后，使用Admin SDK的createCustomToken()方法，将用户名作为自定义UID传入
• 前端拿到自定义令牌后，调用signInWithCustomToken()完成登录
• 最后在数据库中存储用户的额外资料

关键注意事项 #

• 用户名规则：限制可用字符（比如只能用字母、数字、下划线、连字符，避免URL解析问题），设置长度范围，过滤敏感词
• 唯一性校验原子化：用Firestore的set()方法并设置{ merge: false }，或者Realtime Database的事务，确保同时注册不会产生重复用户名
• 安全规则：配置Firestore/Realtime Database的安全规则，确保只有用户自己能修改自己的资料，防止恶意篡改用户名映射

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