react-native-app-auth对接Okta授权：Android App Links报Data intent null错误

问题分析 #

Android端通过App Links能正常跳转回应用，但捕获授权响应时出现[Error: Data intent is null]，核心原因是App Links的https scheme配置未与react-native-app-auth的逻辑正确关联，导致库无法从跳转的Intent中读取授权参数。

解决方案 #

1. 修正授权回调URL配置 #

• Okta后台：添加完整回调URL（例如https://myDomain.com/okta-callback）到允许的重定向URI列表
• AuthConfig：更新redirectUrl为完整路径，避免仅填写域名：

  {
    issuer: "https://dev-xxxxxx.okta.com/oauth2/default",
    clientId: '${MyClientId}',
    clientSecret: '${MyClientSecret}',
    redirectUrl: "https://myDomain.com/okta-callback", // 补充完整回调路径
    scopes: ['openid', 'profile', 'email', 'offline_access'],
  };
  

2. 调整Android Manifest配置 #

修改AndroidManifest.xml中的intent-filter，精确匹配回调URL路径，确保Intent携带的授权参数能被正确识别：

<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="myDomain.com"
        android:path="/okta-callback" />
</intent-filter>

3. 同步build.gradle的重定向Scheme配置 #

将build.gradle中的appAuthRedirectScheme改为https，让react-native-app-auth识别https scheme的回调请求：

manifestPlaceholders = [
    appAuthRedirectScheme: 'https',
]

4. 确保Intent数据传递到RN层 #

在MainActivity.java中重写onNewIntent方法，确保跳转过来的Intent被传递给React Native实例管理器：

import android.content.Intent;
import android.util.Log;
import com.facebook.react.ReactActivity;
import com.facebook.react.ReactNativeHost;
import com.facebook.react.ReactInstanceManager;

public class MainActivity extends ReactActivity {
    // ... 其他原有代码

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        // 打印Intent数据用于调试（可选）
        Log.d("AuthCallback", "Received intent data: " + intent.getData());
        // 将Intent传递给RN实例，确保App Auth能捕获授权参数
        ReactNativeHost host = getReactNativeHost();
        if (host != null) {
            ReactInstanceManager manager = host.getReactInstanceManager();
            if (manager != null) {
                manager.onNewIntent(intent);
            }
        }
    }
}

5. 验证App Links有效性 #

确认https://myDomain.com/.well-known/assetlinks.json文件存在且配置正确，保证Android系统能验证App Links归属，避免跳转时出现应用选择器（可能导致Intent参数丢失）。

6. 升级react-native-app-auth版本 #

若使用旧版本，建议升级到最新稳定版，旧版本对App Links的支持可能存在缺陷。

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