标题：Go 语言中使用 Google OAuth2 获取用户信息的完整实践指南_技术教程

本文详解如何在 go 应用中正确集成 google oauth2，解决常见“获取不到用户信息”问题，涵盖配置、授权码交换、accesstoken 使用及 userinfo 接口调用全流程，并提供可直接运行的健壮示例代码。

在使用 golang.org/x/oauth2（含 golang.org/x/oauth2/google）实现 Google 登录时，一个高频问题是：成功获取 access_token 后，调用 /userinfo/v2/me 却只返回 HTTP 响应结构体，而非预期的 JSON 用户数据。根本原因在于：http.Client 的 Get() 方法返回的是 *http.Response 对象（含状态码、Header 等元信息），并未自动读取并解析响应体（Body）中的 JSON 内容。原始代码中 r.JSON(200, map[string]interface{}{"status": resp}) 实际上传递的是整个 *http.Response 指针，导致输出大量底层网络结构字段，而非用户资料。

✅ 正确做法：显式读取并解析响应体

你需要手动调用 response.Body.Read()（推荐使用 io.ReadAll）获取原始字节，再反序列化为结构体。以下是经过验证的完整、安全、可部署的实现：

package main

import (
    "encoding/json"
    "fmt"
    "io"
    "log"
    "net/http"

    "golang.org/x/oauth2"
    "golang.org/x/oauth2/google"
)

var googleconf = &oauth2.Config{
    ClientID:     "YOUR_CLIENT_ID",     // 替换为 Google Cloud Console 中的 OAuth2 凭据
    ClientSecret: "YOUR_CLIENT_SECRET",
    RedirectURL:  "http://localhost:3000/googlelogin",
    Scopes: []string{
        "https://www.googleapis.com/auth/userinfo.profile",
        "https://www.googleapis.com/auth/userinfo.email", // ⚠️ 必须添加此 scope 才能获取 email
    },
    Endpoint: google.Endpoint,
}

// 第一步：重定向用户至 Google 授权页
func handleAuthRequest(w http.ResponseWriter, r *http.Request) {
    url := googleconf.AuthCodeURL("state", oauth2.AccessTypeOnline)
    http.Redirect(w, r, url, http.StatusFound)
}

// 第二步：处理 Google 回调，获取用户信息
func handleGoogleCallback(w http.ResponseWriter, r *http.Request) {
    // 1. 提取授权码
    code := r.FormValue("code")
    if code == "" {
        http.Error(w, "missing 'code' parameter", http.StatusBadRequest)
        return
    }

    // 2. 用授权码换取 token
    tok, err := googleconf.Exchange(r.Context(), code) // ✅ 推荐使用 r.Context() 替代 oauth2.NoContext（已弃用）
    if err != nil {
        log.Printf("OAuth2 exchange error: %v", err)
        http.Error(w, "failed to exchange code for token", http.StatusInternalServerError)
        return
    }

    // 3. 构建带 AccessToken 的 UserInfo 请求（方式一：手动拼接 URL）
    userInfoURL := "https://www.googleapis.com/oauth2/v2/userinfo?access_token=" + tok.AccessToken
    resp, err := http.Get(userInfoURL)
    if err != nil {
        log.Printf("HTTP GET error: %v", err)
        http.Error(w, "failed to fetch user info", http.StatusInternalServerError)
        return
    }
    defer resp.Body.Close()

    // 4. 读取并解析响应体
    body, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Printf("Read body error: %v", err)
        http.Error(w, "failed to read response", http.StatusInternalServerError)
        return
    }

    // 5. 定义结构体匹配 Google UserInfo 响应
    type UserInfo struct {
        Sub       string `json:"sub"`
        Name      string `json:"name"`
        GivenName string `json:"given_name"`
        FamilyName string `json:"family_name"`
        Picture   string `json:"picture"`
        Email     string `json:"email"`
        EmailVerified bool `json:"email_verified"`
        Locale    string `json:"locale"`
    }

    var user UserInfo
    if err := json.Unmarshal(body, &user); err != nil {
        log.Printf("JSON unmarshal error: %v", err)
        http.Error(w, "invalid user info response", http.StatusInternalServerError)
        return
    }

    // 6. 返回结构化用户数据（生产环境建议使用模板或标准 API 响应格式）
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(map[string]interface{}{
        "success": true,
        "user":    user,
        "token":   map[string]string{"access_token": tok.AccessToken},
    })
}

func main() {
    http.HandleFunc("/googleloginrequest", handleAuthRequest)
    http.HandleFunc("/googlelogin", handleGoogleCallback)

    fmt.Println("Server starting on :3000...")
    log.Fatal(http.ListenAndServe(":3000", nil))
}

? 关键注意事项

Scope 必须完整：若需 email 字段，务必声明 "https://www.googleapis.com/auth/userinfo.email"；仅 userinfo.profile 不包含邮箱。
避免 oauth2.NoContext：该常量已在新版 oauth2 中标记为弃用，应优先使用 r.Context()（如 googleconf.Exchange(r.Context(), code)）。
*不要直接返回 `http.Response**：它不是业务数据，而是 HTTP 协议层对象。始终ReadAll+Unmarshal`。
错误处理不可省略：网络请求、JSON 解析、Token 交换均可能失败，需逐层校验。
AccessToken 安全性：示例中为演示简洁性直接拼接 URL，生产环境建议通过 conf.Client(ctx, tok).Get(...) 复用认证客户端（自动注入 Authorization: Bearer ... Header），更符合 OAuth2 最佳实践：

client := googleconf.Client(r.Context(), tok)
resp, err := client.Get("https://www.googleapis.com/oauth2/v2/userinfo")
// 后续 same as above...

✅ 总结

Google OAuth2 在 Go 中完全可用，核心陷阱在于混淆了 HTTP 响应对象与业务数据。只要牢记「Token 换取 → 构造认证请求 → 读取 Body → 解析 JSON」四步闭环，并严格配置所需 Scope，即可稳定获取用户 ID、姓名、头像、邮箱等标准字段。本方案基于官方 golang.org/x/oauth2，无需引入第三方库，兼容性好、维护性强，适用于各类 Web 登录场景。