Flutter使用aad_oauth实现Google登录因WebView触发403错误的解决方法

问题根源 #

Google的安全浏览器政策明确禁止用嵌入式WebView处理OAuth 2.0登录流程——这类WebView的用户代理会被判定为不安全客户端，直接触发disallowed_useragent错误。

可行解决方案 #

1. 切换到系统默认浏览器登录（首推） #

修改aad_oauth的配置，禁用内置WebView，改用外部浏览器完成登录：

• 初始化AadOAuth实例时，将webViewParameters里的useWebView设为false：

final config = AadOAuthConfig(
  tenant: '你的租户ID',
  clientId: '你的客户端ID',
  scope: '所需权限范围',
  redirectUri: '你的重定向URI',
);
final oauth = AadOAuth(config);
oauth.webViewParameters.useWebView = false;

• 务必在Azure AD应用注册里配置对应平台的重定向URI（比如移动端常用的msal{客户端ID}://auth格式），且保证代码里的URI和注册的完全一致。

2. 临时修改WebView用户代理（不推荐生产环境） #

如果必须保留WebView，可以尝试修改其用户代理，模拟标准浏览器的UA：

oauth.webViewParameters.userAgent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36';

注意：这种方法属于临时 workaround，Google随时可能更新UA检测规则导致失效，且违反安全规范，不建议用于正式环境。

3. 迁移到微软官方MSAL Flutter插件 #

考虑替换为微软官方维护的MSAL Flutter插件，它原生支持调用系统默认浏览器登录，完全符合安全政策，同时提供更全面的Azure AD身份验证能力。

额外要点 #

• Azure AD应用注册时，要选对应用类型（移动/桌面应用），如果是公共客户端，需开启"允许公共客户端流"选项。
• 重定向URI必须和Azure AD后台配置的完全匹配，否则登录后无法正常回调到你的应用。

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