Firebase重置密码链接点击报错"请求的操作无效"排查求助

已完成的排查动作 #

• 已分别测试两种链接访问路径，均复现相同报错：
  • 配置自定义认证动作URL后访问重置密码链接
  • 使用Firebase默认认证处理路径 *.firebaseapp.com/__/auth/handler 访问链接
• 两类场景下页面均弹出「请求的操作无效」提示：
  
• 浏览器控制台同步输出「请求缺少必要数据」日志：
  
• 已核查GCP后台浏览器API密钥配置，确认密钥未设置任何访问限制：
  

可能的故障环节与对应解决方案 #

• 链接核心参数缺失
  常见触发场景：邮件客户端自动改写链接格式、企业网关拦截重写URL、前端路由对链接参数做二次编码转义，导致认证处理所需的oobCode、mode、apiKey三个核心参数不完整。
  解决方式：从服务端生成链接的原始日志中复制完整URL，跳过邮件中转环节直接访问，核对链接中三个核心参数无缺失、无转义错误。
• 授权域名配置不全
  常见触发场景：使用自定义动作URL时，未将自定义域名加入Firebase Auth的授权域名白名单，认证服务会直接拦截跨域请求，返回操作无效提示。
  解决方式：进入Firebase控制台「认证-设置-授权域名」配置页，将所有承载认证处理页面的域名全部加入白名单，包括自定义域名、默认的firebaseapp.com域名。
• 链接状态失效
  常见触发场景：重置密码链接默认有效期为1小时，重新生成新链接后旧链接会立即失效，访问旧链接时会因校验失败返回参数缺失的报错。
  解决方式：重新触发一次密码重置流程，获取新生成的链接后在有效期内完成访问操作。
• 认证处理页面配置不匹配
  常见触发场景：自定义域名下的认证处理页面未正确初始化与当前项目匹配的Firebase SDK，无法读取请求对应的项目配置，触发控制台“缺少必要数据”的报错。
  解决方式：确认自定义域名下/__/auth/handler路径的服务部署正常，SDK初始化传入的apiKey、projectId、authDomain与项目实际配置完全一致。
• 跳转链路参数丢失
  常见触发场景：生成重置链接时启用了动态链接跳转，但未配置动态链接对应的认证处理规则，跳转过程中丢失认证核心参数。
  解决方式：在Firebase认证的邮件模板设置中，确认密码重置动作的跳转规则为直接指向认证处理路径，不额外经过动态链接中转。

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