使用expo-auth-session集成Identity Server登录后重定向回APP遇路由不匹配错误

我正在为某网站开发移动端版本，采用Identity Server进行身份认证，使用expo-auth-session处理认证流程，但目前遇到登录后无法正常重定向回APP的问题，返回“unmatched route”（路由不匹配）错误。后端数据库中已保存的重定向URI为com.eltizam.app和com.eltizam.app://signin-oidc，期望完成登录后浏览器能重定向回APP并带回授权码（code）以获取访问令牌（access token）。

登录组件代码如下：

const clientId = 'Android.Hybrid';
const clientSecret = 'And@Passw0rd';
const scopes = ['openid', 'profile', 'MotorInsurance', 'Identity', 'offline_access'];
const codeChallengeMethod = 'S256';

const extraParams = {};
const redirectUri = 'com.eltizam.app://signin-oidc';
const discovery = AuthSession.useAutoDiscovery('https://api-qc.eltizam.sa/identity');
// Create and load an auth request,
const [request, result, promptAsync] = AuthSession.useAuthRequest(
  {
    clientId,
    responseType: 'code',

    redirectUri,
    clientSecret,
    scopes,
  },
  discovery
);


return (
  <View style={styles.container}>
    <ButtonComponent
      handlePress={() => promptAsync()}       
    />
  </View>
);
};

export default Logi

排查方向及解决方案 #

• 确认Expo Scheme配置：必须在app.json或app.config.js中配置APP的自定义URL scheme，否则系统无法识别重定向链接并唤起APP。配置示例：

{
  "expo": {
    "scheme": "com.eltizam.app",
    // 其他项目配置...
  }
}

配置完成后需要重启Expo开发服务，确保配置生效。

• 补全PKCE相关参数：你定义了codeChallengeMethod = 'S256'，但未在认证请求中传入对应的code challenge和code verifier。Authorization Code Flow with PKCE是Expo推荐的安全认证方式，缺失这些参数会导致认证流程异常。可以用expo-auth-session提供的工具方法生成：

import { generateCodeVerifier, generateCodeChallenge } from 'expo-auth-session';

// 在组件内部生成（建议放在useEffect或组件初始化逻辑中）
const codeVerifier = generateCodeVerifier();
const codeChallenge = await generateCodeChallenge(codeVerifier);

// 更新AuthRequest配置
const [request, result, promptAsync] = AuthSession.useAuthRequest(
  {
    clientId,
    responseType: 'code',
    redirectUri,
    clientSecret,
    scopes,
    codeChallenge,
    codeChallengeMethod: 'S256',
  },
  discovery
);

注意：生成的codeVerifier需要妥善保存，后续换取access token时必须使用它。

• 检查Identity Server客户端配置：

  1. 确保客户端Android.Hybrid的Allowed Grant Types包含Authorization Code；
  2. 确认已开启PKCE支持（若使用PKCE流程）；
  3. 核对重定向URI的拼写、大小写、格式完全一致，避免多余的斜杠或空格。

• 调整promptAsync调用参数：在部分Android设备上，添加useProxy: true参数可以解决重定向唤起APP失败的问题：

<ButtonComponent
  handlePress={() => promptAsync({ useProxy: true })}       
/>

• 更新expo-auth-session版本：旧版本可能存在重定向相关的bug，执行expo install expo-auth-session更新到最新稳定版。

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