React Native Firebase安卓生产版无密码邮件跳转失败问题

问题概述 #

仅Play商店分发的Android生产版APP存在以下异常：

• 用户点击邮件中的Dynamic Link后，页面闪烁但跳转失败
• 手动打开APP后可自动完成登录
• 本地构建版本、使用相同凭据的测试商店版本均无异常
• 已确认Play Console的Upload Key与本地release.keystore一致，且Upload和App签名密钥已添加至Firebase项目
• 当前使用AppCenter构建分发应用，频繁通过CodePush推送补丁

排查与解决步骤 #

1. 核对Firebase的签名密钥配置 #

虽然已添加密钥，但需重点确认：

• Firebase项目设置中，是否将Google Play自动生成的App签名密钥（而非本地Upload Key）的SHA-1/SHA-256指纹添加到对应Android应用的签名证书列表中
• 检查Dynamic Link的「关联应用」配置，包名与签名指纹是否完全匹配生产版APP的实际签名（Play商店生产版默认使用App签名密钥）

2. 排查CodePush补丁的影响 #

频繁推送补丁可能覆盖或破坏跳转逻辑：

• 回滚最近一次CodePush补丁，测试跳转是否恢复正常
• 检查补丁中是否修改了Deep Link相关的原生代码（比如MainActivity的onNewIntent方法）或RN端的Linking监听逻辑

3. 完善AndroidManifest的Deep Link配置 #

现有配置已包含自定义scheme，可补充以下内容：

• 为Dynamic Link的HTTPS域名添加对应的intent-filter（以https://yourapp.page.link为例）：

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW"/>
    <category android:name="android.intent.category.DEFAULT"/>
    <category android:name="android.intent.category.BROWSABLE"/>
    <data android:scheme="https" android:host="yourapp.page.link"/>
</intent-filter>

• 确认android:exported="true"在MainActivity上已正确配置，且打包后未被修改

4. 检查混淆规则（ProGuard/R8） #

即使enableProguardInReleaseBuilds=false，仍需确保关键类未被混淆：

• 在proguard-rules.pro中添加Firebase Dynamic Link相关保留规则：

-keep class com.google.firebase.dynamiclinks.** { *; }
-keep class com.google.android.gms.common.api.ResultCallback { *; }
-keep class com.google.android.gms.tasks.OnSuccessListener { *; }

• 确认生产构建时未意外启用R8混淆

5. 验证AppCenter的构建签名配置 #

确保AppCenter构建使用了正确的签名密钥：

• 检查AppCenter的构建环境变量（MYAPP_RELEASE_STORE_FILE、MYAPP_RELEASE_KEY_ALIAS等）是否与本地一致
• 对比AppCenter构建的APK签名指纹与本地Release版，确认两者匹配（可通过keytool工具查看）

生产版调试技巧 #

• 生成Firebase Dynamic Link的调试版本，查看跳转过程的日志信息
• 在Play Console中启用应用内错误报告，收集生产版的异常日志
• 使用Android Studio的App Bundle Explorer，检查Play商店分发的APK的Manifest和签名配置是否正确

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