Xamarin Forms集成Google OAuth2认证遇WebAuthenticator回调错误

问题背景 #

我正在开发基于Xamarin Forms的应用，通过OAuth2实现Google认证。因现有集成示例大多过时，遵循微软最新指引，采用Xamarin Essentials配合ASP.NET Core后端代理请求至身份提供商。

已完成以下配置：

• Google云控制台：将OAuth Web应用的重定向URL设为https://my-google-app.appspot.com/signin-google，ASP.NET Core应用基础地址为https://my-google-app.appspot.com
• 深度链接回调方案设置为someappname://abc（Android包名：com.my-app-package-name），通过Xamarin Essentials发起认证请求：

  var result = await WebAuthenticator.AuthenticateAsync(
              new Uri("https://my-google-app.appspot.com/mobileauth/Google"),
              new Uri("someappname://abc"));
  

• Android项目中定义IntentFilter并继承WebAuthenticatorCallbackActivity：

  [Activity(NoHistory = true, LaunchMode = LaunchMode.SingleTop, Exported = true)]
  [IntentFilter(new []{Android.Content.Intent.ActionView},
      Categories = new[] {Android.Content.Intent.CategoryDefault, Android.Content.Intent.CategoryBrowsable},
      DataPath = "abc",
      DataSchemes = new[]
          {
              "someappname"  /* package id */
          })
  ]
  
  public class WebAuthenticationCallbackActivity : Xamarin.Essentials.WebAuthenticatorCallbackActivity
  {
  }
  

运行时抛出错误：

System.InvalidOperationException: 'You must subclass the WebAuthenticatorCallbackActivity and create an IntentFilter for it which matches your callbackUrl.

虽清楚Google会先重定向至ASP.NET实例再跳转回应用，但调整回调URL后问题仍存在。

排查与修复步骤 #

1. 修正IntentFilter的匹配规则 #

你的回调URL是someappname://abc，当前IntentFilter的DataPath配置可能存在匹配偏差。Android的IntentFilter路径匹配默认是精确匹配，需确保路径格式完全一致：

[Activity(NoHistory = true, LaunchMode = LaunchMode.SingleTop, Exported = true)]
[IntentFilter(new[] { Android.Content.Intent.ActionView },
    Categories = new[] { Android.Content.Intent.CategoryDefault, Android.Content.Intent.CategoryBrowsable },
    DataSchemes = new[] { "someappname" },
    DataHost = "", // 回调URL无host，留空匹配
    DataPath = "/abc" // 显式添加斜杠，确保路径完全匹配
)]
public class WebAuthenticationCallbackActivity : Xamarin.Essentials.WebAuthenticatorCallbackActivity
{
}

2. 确认AndroidManifest的Activity注册 #

手动检查AndroidManifest.xml，确保回调Activity已正确注册（避免属性自动同步失败）：

<activity android:name=".WebAuthenticationCallbackActivity" 
          android:noHistory="true" 
          android:launchMode="singleTop" 
          android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="someappname" android:path="/abc" />
    </intent-filter>
</activity>

3. 验证后端重定向逻辑 #

确认ASP.NET Core的MobileAuthController在完成Google认证后，重定向的URL完全是someappname://abc，没有额外的路径、参数或拼写错误。可以在后端调试时输出最终重定向地址，确保和前端设置的回调URL一致。

4. 清理重建项目 #

Xamarin缓存可能导致配置不生效，执行以下操作：

• 清理解决方案
• 删除所有项目的bin和obj文件夹
• 重新编译整个解决方案，优先编译Android项目

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