Firebase无密码邮箱验证链接未使用指定自定义域名与路径如何解决

AI 小北

2026-9-23

问题原因

Firebase Auth邮箱验证/无密码登录链接默认采用动态链接包装逻辑：你在控制台邮件模板中填写的「操作URL」会被作为link查询参数，挂载到项目绑定的动态链接域名的根路径下，而非直接将验证参数拼接在你指定的/onboard路径后，因此会生成https://example.com/?link=https://example.com/onboard?apiKey...格式的链接。

解决方案

配置动态链接专属路径前缀
进入Firebase控制台「动态链接」板块，为邮箱验证类操作设置/onboard/作为专属路径前缀，调整后生成的验证链接会变为https://example.com/onboard/?link=xxx格式，此时你的apple-app-site-association文件仅需保留/onboard/*的匹配规则即可，不会影响其他路径的链接打开逻辑。
手动构造验证链接覆盖默认规则
若需要完全自定义链接结构，可通过Firebase Auth接口手动生成登录验证链接：iOS端调用generateSignInLink(withEmail:actionCodeSettings:completion:)方法，在ActionCodeSettings配置中指定url为https://example.com/onboard，同时开启handleCodeInApp为true，且将动态链接域名前缀配置为https://example.com/onboard，即可生成参数直接拼接在/onboard路径后的目标格式链接。
补充AASA路径排除规则
若不修改Firebase侧配置，可直接调整apple-app-site-association的路径匹配规则，利用AASA的顺序匹配优先级，设置如下规则即可：
```
"paths": [
  "/onboard/*",
  "NOT /*"
]
```
该配置下只有匹配/onboard/*的链接会触发应用跳转，其余路径链接默认走Safari打开。