AndroidX项目集成Facebook登录依赖触发Duplicate class构建错误

你引入的com.facebook.android:facebook-login:5.15.3属于未完成原生AndroidX适配的历史版本SDK，它内部通过传递依赖硬编码引入了旧版com.android.support 27.0.2系列的customtabs、support-compat、support-media-compat库，和你项目已经完成迁移的AndroidX生态对应库（androidx.browser:browser、androidx.core:core、androidx.media:media）的类定义完全重合，即便开启了jetifier适配，也会因为依赖优先级的问题出现Duplicate class报错。

可直接落地的冲突解决步骤 #

1. 精准过滤Facebook SDK带入的旧support依赖
   在app模块的build.gradle dependencies块中，仅保留facebook-login单模块依赖，不要引入冗余的全量聚合包com.facebook.android:facebook-android-sdk，同时给依赖加排除规则，过滤所有旧com.android.support系列的传递依赖：

   implementation('com.facebook.android:facebook-login:5.15.3') {
       // 全量排除该依赖引入的所有旧com.android.support组件
       exclude group: 'com.android.support'
       // 定向排除已知冲突的三个support模块
       exclude group: 'com.android.support', module: 'customtabs'
       exclude group: 'com.android.support', module: 'support-compat'
       exclude group: 'com.android.support', module: 'support-media-compat'
   }
   

   重点提示：全量facebook-android-sdk依赖会引入分享、社交图谱、广告归因等你当前场景用不到的模块，是额外冲突的主要来源，仅需要登录功能时只引facebook-login单模块即可。
2. 配置全局依赖强制对齐规则
   在app模块build.gradle的dependencies块上方，增加全局依赖解析策略，把所有漏网的旧support依赖强制替换为项目当前使用的AndroidX对应库，避免低优先级的旧support依赖被加载：

   configurations.all {
       resolutionStrategy {
           // 强制对齐AndroidX对应库版本，覆盖旧support依赖的加载请求
           force 'androidx.browser:browser:1.4.0'
           force 'androidx.core:core:1.9.0'
           force 'androidx.media:media:1.6.0'
           // 兜底规则：所有加载com.android.support组件的请求，直接替换为兼容版本的support注释库
           eachDependency { details ->
               if (details.requested.group == 'com.android.support') {
                   details.useTarget "com.android.support:support-annotations:28.0.0"
               }
           }
       }
   }
   

3. 打开AndroidX适配兜底开关
   检查项目根目录下的gradle.properties文件，确保两个适配开关为开启状态，无注释锁定：

   android.useAndroidX=true
   android.enableJetifier=true
   

   该配置会让Gradle加载第三方AAR时，自动把AAR内部硬编码的旧support类路径改写为对应AndroidX路径，兜住排除规则没覆盖到的SDK内部残留引用。
4. 清理旧构建缓存后重新构建
   配置修改完成后，通过Gradle面板执行clean任务清空本地旧构建缓存，再重新执行assembleDebug构建，避免残留缓存导致的报错误判。

实操避坑说明 #

• 不要为了消冲突随意降级项目已有的AndroidX依赖版本，所有适配动作都围绕“替换旧support依赖为现有AndroidX对应库”展开，避免破坏已经完成的AndroidX架构迁移。
• 排除依赖后如果出现Facebook SDK类找不到的报错，只需要补入对应功能的AndroidX依赖即可（比如缺CustomTabs相关类就补androidx.browser:browser，缺媒体兼容类就补androidx.media:media），绝不能回退引入旧版com.android.support系列库。

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