Flutter集成Gmail API遇认证问题，求解决方案

一、先解决Postman中的401认证错误 #

你的请求返回401是因为当前使用的Bearer token无效或权限不足，按以下步骤修正：

• 确保token是通过OAuth 2.0授权流程获取的，且包含Gmail API所需权限（如gmail.readonly、gmail.modify等）
• 避免手动粘贴过期token，直接在Postman中使用OAuth2授权模式：
  1. 新建请求，选择Authorization标签，类型选OAuth 2.0
  2. 配置Auth URL、Access Token URL、Client ID、Client Secret，勾选所需权限范围
  3. 点击"Get New Access Token"完成授权，Postman会自动带上有效token

二、Flutter中正确集成Gmail API的步骤 #

推荐使用官方生态的包组合：google_sign_in + googleapis + googleapis_auth，配置和实现更稳定：

1. 谷歌云控制台前置配置 #

• 创建项目并启用Gmail API
• 创建OAuth客户端ID：
  • Android：填写包名和SHA-1指纹，生成的客户端ID对应的redirectUri格式为{你的包名}:/oauth2callback
  • iOS：填写Bundle ID，redirectUri格式为{你的Bundle ID}://oauth2callback
• 记录下Client ID、包名/Bundle ID，后续代码和配置需要用到

2. 项目依赖配置 #

在pubspec.yaml中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  google_sign_in: ^6.2.1
  googleapis: ^13.0.0
  googleapis_auth: ^1.5.0
  extension_google_sign_in_as_googleapis_auth: ^2.0.12

3. 平台端配置 #

Android端（AndroidManifest.xml）

在<application>标签内添加：

<intent-filter>
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
  <!-- 替换成你的redirectUri对应的scheme -->
  <data android:scheme="com.your.app.package" />
</intent-filter>

iOS端（Info.plist）

添加以下配置：

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <!-- 替换成你的Bundle ID -->
      <string>com.your.app.bundle</string>
    </array>
  </dict>
</array>
<key>LSApplicationQueriesSchemes</key>
<array>
  <string>googlechrome</string>
  <string>com.googleusercontent.apps.{你的Client ID前半部分}</string>
</array>

4. 核心代码实现 #

import 'package:flutter/material.dart';
import 'package:google_sign_in/google_sign_in.dart';
import 'package:googleapis/gmail/v1.dart';
import 'package:googleapis_auth/googleapis_auth.dart' as auth;
import 'package:extension_google_sign_in_as_googleapis_auth/extension_google_sign_in_as_googleapis_auth.dart';

class GmailApiService {
  final GoogleSignIn _googleSignIn = GoogleSignIn(
    scopes: [
      GmailApi.gmailReadonlyScope,
      // 根据需求添加其他权限，如GmailApi.gmailModifyScope
    ],
    clientId: '你的OAuth客户端ID',
  );

  // 登录并获取Gmail客户端
  Future<GmailApi?> signInAndGetGmailClient() async {
    try {
      final GoogleSignInAccount? account = await _googleSignIn.signIn();
      if (account == null) return null;

      final auth.AuthClient client = await account.authenticatedClient();
      return GmailApi(client);
    } catch (e) {
      print('认证失败: $e');
      return null;
    }
  }

  // 获取用户邮件列表
  Future<void> fetchEmails() async {
    final GmailApi? gmailApi = await signInAndGetGmailClient();
    if (gmailApi == null) return;

    try {
      final ListMessagesResponse response = await gmailApi.users.messages.list('me');
      print('邮件数量: ${response.messages?.length}');
      // 处理邮件数据
    } catch (e) {
      print('获取邮件失败: $e');
    }
  }
}

5. 常见问题排查 #

• redirectUri配置错误：确保平台端配置的scheme和代码中GoogleSignIn的clientID对应的redirectUri一致
• 权限范围缺失：登录时必须请求Gmail API所需的权限范围，否则调用API会返回权限不足错误
• token过期：google_sign_in会自动处理token刷新，无需手动维护

内容的提问来源于stack exchange，提问作者Saayeed M Daawoud