Troubleshooting

This guide covers common issues you might encounter when integrating the Facebook SDK into your React Native app and how to resolve them.

Common Issues

1. Android project fails to run

Problem: Your Android app crashes or fails to build after installing the SDK.Solution:

Make sure you’ve added the required code in your AndroidManifest.xml and res/values/strings.xml with your Facebook app settings
Verify you’ve followed all steps in the Android configuration guide
Check that your Facebook App ID and Client Token are correctly configured

Ensure your strings.xml includes:

<string name="facebook_app_id">YOUR_APP_ID</string>
<string name="facebook_client_token">YOUR_CLIENT_TOKEN</string>

2. Duplicate symbol errors (iOS)

Problem: You get duplicate symbol errors when building for iOS.Solution:Make sure that FBSDKCoreKit.framework, FBSDKLoginKit.framework, and FBSDKShareKit.framework are not in Link Binary with Libraries for your root project when using CocoaPods.These frameworks should only be linked through CocoaPods, not manually added to your project.

3. Build error: 'no type or protocol named UIApplicationOpenURLOptionsKey' (iOS)

Problem: Xcode shows a compilation error about UIApplicationOpenURLOptionsKey.Solution:Your Xcode version is too old. Upgrade to Xcode 10.0 or later.This type is only available in recent versions of iOS SDK that ship with Xcode 10+.

4. Undefined symbols for architecture x86_64 (iOS)

Problem: You get a compilation error with undefined Swift symbols:

Undefined symbols for architecture x86_64:
  "_swift_FORCE_LOAD$_swiftUniformTypeIdentifiers"
  "_swift_FORCE_LOAD$_swiftCoreMIDI"
  "_swift_FORCE_LOAD$_swiftWebKit"

Solution:After facebook-ios-sdk v7, parts of the SDK are written in Swift. You need to coordinate Swift language usage with Objective-C.Option 1: Add an empty Swift file (Recommended)

In Xcode, add a new file named File.swift to your main project folder
When Xcode asks if you want to “Create Bridging Header”, click Yes

This automatically adds the required Swift library search paths to your build settings:

$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME)
$(TOOLCHAIN_DIR)/usr/lib/swift-5.0/$(PLATFORM_NAME)

Option 2: Update PodfileAdd this to the post_install section of your Podfile, then run pod deintegrate && pod install:

# Mixing Swift and Objective-C in a react-native project may be problematic.
# Workaround: https://github.com/facebookarchive/react-native-fbsdk/issues/755#issuecomment-787488994
installer.aggregate_targets.first.user_project.native_targets.each do |target|
  target.build_configurations.each do |config|
    config.build_settings['LIBRARY_SEARCH_PATHS'] = ['$(inherited)', '$(SDKROOT)/usr/lib/swift']
  end
end

See this issue for more details.

5. AppLink.fetchDeferredAppLink does not work (iOS)

Problem: Deferred app links are not working on iOS.Solution:Both the Facebook App and your app must have App Tracking Transparency (ATT) permission granted for Facebook deferred app links to work.Make sure:

Your app requests ATT permission using requestTrackingPermissionsAsync or similar
The user has granted tracking permission to both your app and the Facebook app
You’ve added NSUserTrackingUsageDescription to your Info.plist

See this related issue for more information.

6. Exception: 'App ID not found' (iOS)

Problem: You get an exception:

App ID not found. Add a string value with your app ID for the key 
FacebookAppID to the Info.plist or call [FBSDKSettings setAppID:].

Solution:If you’re certain that you have the FacebookAppID in your Info.plist or that you’ve called Settings.setAppID(), you may be able to fix it by adding the following to your AppDelegate.m inside the application:didFinishLaunchingWithOptions: method, just before the return YES statement:

[[FBSDKApplicationDelegate sharedInstance] application:application
                      didFinishLaunchingWithOptions:launchOptions];

Make sure this initialization happens early in your app’s launch cycle.

7. Events not showing in Facebook Events Manager

Problem: You’re logging events but they don’t appear in the Facebook Events Manager dashboard.Solution:For events to show up in the Events Manager, you need:

Run the app on a real device (not simulator)
Have the Facebook app running in the background and logged in to an account
Add that Facebook account as an “Advertising Account” for your app in Facebook’s dashboard
Most important: Have ATT (App Tracking Transparency) enabled on both:
- The Facebook app
- Your app

Facebook determines which events to show based on who is logged in on the Facebook App. Only events from accounts added as “Advertising Accounts” will be visible.

How to add an Advertising Account:

Go to Facebook App Dashboard
Select your app
Go to Settings > Advanced
Under Advertising Accounts, add the relevant accounts

8. Login error on Android: 'Error logging you into this application'

Problem: When attempting to log in via the native Facebook app on Android, you get an error: “There is an error in logging you into this application.”Solution:This typically means the appropriate signing certificate hash hasn’t been saved to your Facebook app.

For Development:

Generate your development key hash:

keytool -exportcert -alias androiddebugkey -keystore ~/.android/debug.keystore | openssl sha1 -binary | openssl base64

(Default password is usually android)

Add it to your Facebook app dashboard under Settings > Basic > Key Hashes

For Release (Google Play signing):

If Google is signing your releases, you’ll need to get the SHA-1 from the Play Console:

Go to Play Console
Navigate to Release > App signing > App signing key certificate
Copy the SHA-1 certificate fingerprint

Convert it to base64:

echo YOUR_SHA1_HERE | xxd -r -p | openssl base64

Add the resulting hash to your Facebook app settings

For Internal Testing:

If you’re using App Tester for internal releases:

Get the SHA-1 from Release > Internal app sharing > Internal test certificate
Run the same command to convert it
Add that hash as well

You can find detailed instructions here.

9. Forced to use 'limited' login on iOS

Problem: iOS forces the limited login experience even though you didn’t request it.Solution:Although the official documentation doesn’t explicitly state this, the App Tracking Transparency (ATT) permission is required to use the non-limited/default login on iOS devices.Note: This works fine on Android without the permission.

How to fix:

Request ATT permission before attempting login:

import { requestTrackingPermissionsAsync } from 'expo-tracking-transparency';
// or use react-native-tracking-transparency

const { status } = await requestTrackingPermissionsAsync();
if (status === 'granted') {
  // User granted permission - default login will work
} else {
  // User denied - limited login will be used
}

Make sure NSUserTrackingUsageDescription is in your Info.plist:

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

If the user allows ATT, the default Facebook login page will open. If disabled, the limited version of login will be used, which makes some Graph API endpoints unusable.For more information, see Limited Login documentation.

Problem: Login works in the browser but fails when the Facebook app is installed on the device. Solution: Make sure you’ve implemented the openURL method correctly in your AppDelegate. Without it, the Facebook app cannot redirect back to your app after authentication.

For Objective-C (React Native 0.76 and below):

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
  return [[FBSDKApplicationDelegate sharedInstance]application:app
                                                      openURL:url
                                                      options:options];
}

For Swift (React Native 0.77 and above):

public override func application(
  _ app: UIApplication,
  open url: URL,
  options: [UIApplication.OpenURLOptionsKey: Any] = [:]
) -> Bool {
  let handledByFB = ApplicationDelegate.shared.application(
    app, open: url, options: options)
  let handledBySuper = super.application(
    app, open: url, options: options)
  return handledByFB || handledBySuper
}

See this issue for more details.

Deep Linking Conflicts with Facebook SSO

Problem: Using RCTLinkingManager causes Facebook login to fail. Solution: Always check Facebook SDK before RCTLinkingManager in the openURL method. If RCTLinkingManager is placed first, it will intercept the Facebook SSO callback URL.

Objective-C:

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
  // Check Facebook FIRST
  if ([[FBSDKApplicationDelegate sharedInstance] application:app openURL:url options:options]) {
    return YES;
  }
  
  // Then check RCTLinkingManager
  if ([RCTLinkingManager application:app openURL:url options:options]) {
    return YES;
  }
  
  return NO;
}

Swift:

public override func application(
  _ app: UIApplication,
  open url: URL,
  options: [UIApplication.OpenURLOptionsKey: Any] = [:]
) -> Bool {
  // IMPORTANT: Facebook SDK must be checked FIRST
  let handledByFB = ApplicationDelegate.shared.application(
    app, open: url, options: options)
  
  // Then React Native Linking
  let handledByRN = RCTLinkingManager.application(
    app, open: url, options: options)
  
  // Finally super
  let handledBySuper = super.application(
    app, open: url, options: options)
  
  return handledByFB || handledByRN || handledBySuper
}

Getting Help

If you’re still experiencing issues:

Check the GitHub Issues for similar problems
Review the Facebook SDK documentation
Create a new issue with:
- React Native version
- react-native-fbsdk-next version
- Platform (iOS/Android)
- Complete error messages
- Relevant code snippets

Get Started

Platform Setup

Core Concepts

Features

Guides

Common Issues

How to add an Advertising Account:

For Objective-C (React Native 0.76 and below):

For Swift (React Native 0.77 and above):

Deep Linking Conflicts with Facebook SSO

Objective-C:

Swift:

Getting Help

See Also

Build docs developers (and LLMs) love

Get Started

Platform Setup

Core Concepts

Features

Guides

​Common Issues

​How to add an Advertising Account:

​For Development:

​For Release (Google Play signing):

​For Internal Testing:

​How to fix:

​Login Doesn’t Work When Facebook App is Installed

​For Objective-C (React Native 0.76 and below):

​For Swift (React Native 0.77 and above):

​Deep Linking Conflicts with Facebook SSO

​Objective-C:

​Swift:

​Getting Help

​See Also

Build docs developers (and LLMs) love

Common Issues

How to add an Advertising Account:

For Development:

For Release (Google Play signing):

For Internal Testing:

How to fix:

Login Doesn’t Work When Facebook App is Installed

For Objective-C (React Native 0.76 and below):

For Swift (React Native 0.77 and above):

Deep Linking Conflicts with Facebook SSO

Objective-C:

Swift:

Getting Help

See Also