TestFlight中React Native iOS应用白屏及AzureAuth授权异常排查

一、TestFlight白屏与AzureAuth授权报错的关联 #

你之前的白屏问题大概率是授权流程抛出未捕获错误，导致App界面渲染阻塞；添加登录页文本后能正常显示，说明main.jsbundle等资源已加载正常，核心问题聚焦在AzureAuth的授权回调配置上。

二、iOS端AzureAuth的redirectUri正确配置 #

1. 格式要求 #

不需要以https开头，iOS使用自定义URL Scheme作为回调地址，常见两种格式：

• Azure自动生成格式：msal{你的ClientID}://auth（推荐，避免自定义冲突）
• 自定义格式：{你的Bundle Identifier}://{自定义路径}，比如com.yourcompany.yourapp://auth/callback

2. 关键配置步骤 #

（1）Azure AD应用注册端

• 进入Azure Portal应用注册页面，找到你的应用 →「身份验证」→「添加平台」→ 选择「移动和桌面应用」
• 在iOS/macOS区域，系统会自动生成msal{ClientID}://auth格式的redirectUri，直接启用即可；若用自定义格式，手动添加到重定向URI列表中。

（2）Xcode项目端

• 打开Xcode，进入目标App的「Info」标签页
• 展开「URL Types」，点击「+」新增条目
• 在「URL Schemes」中填入redirectUri的协议部分：
  • 若用msal{ClientID}://auth，则填msal{你的ClientID}
  • 若用自定义格式com.yourcompany.yourapp://auth/callback，则填com.yourcompany.yourapp
• 「Identifier」可填写与Bundle Identifier一致的值。

（3）代码配置端

确保AzureAuth实例的redirectUri与Azure AD注册的地址完全一致，示例：

const azureAuth = new AzureAuth({
  // 其他配置...
  redirectUri: 'msalxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx://auth', // 替换为你的实际值
  // 其他配置...
});

三、iOS与Android的差异原因 #

Android可借助系统默认浏览器回调机制（如Chrome自定义标签），部分库会自动处理回调逻辑，无需显式配置redirectUri；但iOS的ASWebAuthenticationSession（或SafariViewController）必须依赖明确的自定义URL Scheme识别回调归属的App，因此必须手动配置redirectUri和对应URL Scheme，否则无法完成授权回调，进而抛出错误。

四、排查"Unknown WebAuth error"的额外建议 #

• 连接TestFlight安装的设备到Xcode，查看控制台详细错误日志，该通用错误背后通常有具体原因（如redirectUri不匹配、URL Scheme未配置、权限未授权等）。
• 确认TestFlight构建的Bundle Identifier与Azure AD应用注册中配置的完全一致，避免环境不匹配。
• 检查调用authorize时传入的scope（openid profile User.Read Mail.Read），确保这些权限已在Azure AD应用的「API权限」中添加并完成管理员授权。

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