Expo集成Clerk OAuth遇TestFlight部署错误：未定义自定义Scheme无法深层链接

云原生阿岚

2026-7-1

解决Expo + Clerk OAuth在TestFlight部署后的深层链接错误

虽然Clerk封装了OAuth流程，但Expo独立应用（TestFlight包）必须配置自定义URL Scheme才能完成OAuth回调跳转——这是iOS原生应用的硬性要求，Clerk无法替你自动生成唯一的scheme，需要手动配置。

1. 在Expo配置文件中添加自定义Scheme
打开项目根目录的app.json或app.config.js，在expo节点下添加scheme字段，值设为你的应用专属标识（比如com.yourcompany.yourapp，确保全网唯一）：
```
{
  "expo": {
    "scheme": "com.yourcompany.yourapp",
    // 其他原有配置（name, slug, ios等）
  }
}
```
2. 更新Clerk后台的OAuth回调地址
登录Clerk控制台，进入你的应用，依次打开Authentication > Social Connections，为每个OAuth提供商（Google/Facebook/Apple）设置回调URL：
格式：你的scheme://oauth/redirect，比如com.yourcompany.yourapp://oauth/redirect
注意：Apple登录还需要额外配置Team ID、Bundle ID等信息，确保和Expo的iOS配置一致。
3. 重新构建TestFlight包
修改配置后，必须重新生成iOS构建包：
```
eas build --platform ios
```
构建完成后，重新上传到TestFlight并安装测试，旧包因缺少scheme配置会继续报错。
4. 验证Scheme是否生效（可选）
用Expo的uri-scheme工具测试能否唤起App：
```
npx uri-scheme open com.yourcompany.yourapp://oauth/redirect --ios
```
如果能正常唤起App，说明scheme配置生效。