Flutter Android模块Facebook登录问题：Debug正常但Release APK报错

我之前在做Flutter项目时也碰到过一模一样的问题——Debug模式下Facebook登录顺顺当当，打包成Release APK就弹出这个错误，折腾了好一阵才搞定。下面是几个最可能的原因和对应的解决办法，你可以挨个排查：

1. 最常见：Release签名哈希值未配置 #

Facebook的登录验证依赖应用的签名哈希值，Debug和Release用的是不同的签名文件，如果你只在开发者后台添加了Debug的哈希值，Release包肯定会验证失败。

获取Release签名哈希值的命令：

keytool -exportcert -alias <你的Release keystore别名> -keystore <你的Release keystore文件路径> | openssl sha1 -binary | openssl base64

• 注意替换<你的Release keystore别名>和<你的Release keystore文件路径>，Windows系统可以用Git Bash来执行这个命令更方便。
• 把生成的哈希值复制到Facebook开发者后台的「应用设置」→「基本」→「Key Hashes」列表里，保存更新。

2. ProGuard/R8混淆破坏了Facebook SDK #

Release包默认会开启代码混淆，如果没有配置规则保护Facebook相关类，会导致SDK无法正常工作。

打开android/app/proguard-rules.pro，添加以下混淆规则：

-keep class com.facebook.** { *; }
-keep interface com.facebook.** { *; }
-dontwarn com.facebook.**

然后检查android/app/build.gradle的buildTypes.release块，确保开启了混淆并引用了这个规则文件：

release {
    signingConfig signingConfigs.release
    minifyEnabled true
    proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}

3. Facebook应用状态或权限问题 #

• 检查Facebook开发者后台的应用状态：如果应用还处于「In Development（开发中）」状态，只有添加的测试用户能登录，普通用户在Release包会被拒绝。需要把应用切换到「Live（上线）」状态。
• 确认你请求的登录权限是否已经在后台配置，并且如果是需要审核的权限（比如public_profile之外的），是否已经通过Facebook的审核。

4. 依赖包版本兼容性问题 #

flutter_facebook_login这个包已经有一段时间没更新了，可能和新版本的Flutter、Android Gradle插件或者Facebook SDK不兼容。

• 可以尝试把flutter_facebook_login升级到最新版本，看看问题是否解决。
• 如果升级后还是不行，建议换成维护更活跃的Facebook登录Flutter包，兼容性会更好。

5. AndroidManifest配置遗漏或错误 #

确保android/app/src/main/AndroidManifest.xml里的Facebook相关配置完整且正确：

<meta-data
    android:name="com.facebook.sdk.ApplicationId"
    android:value="@string/facebook_app_id"/>

<activity
    android:name="com.facebook.FacebookActivity"
    android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
    android:label="@string/app_name" />

<activity
    android:name="com.facebook.CustomTabActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="@string/fb_login_protocol_scheme" />
    </intent-filter>
</activity>

同时检查android/app/src/main/res/values/strings.xml里的配置：

<string name="facebook_app_id">你的Facebook应用ID</string>
<string name="fb_login_protocol_scheme">fb你的Facebook应用ID</string>

注意fb_login_protocol_scheme的格式是fb加上你的应用ID，不要写错。

我当时是同时犯了「没加Release哈希值」和「没配置混淆规则」两个错误，排查后很快就解决了。你可以先从哈希值和混淆这两点入手，大概率能搞定这个问题。

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