本文详解 go 中调用 github oauth 令牌接口失败（404）的常见原因，重点解决因 json 字段不可导出导致请求体为空的问题，并提供可直接运行的修复代码与最佳实践。
GitHub OAuth Web 流程中，前端重定向用户至 https://github.com/login/oauth/authorize 获取授权码（code）后，服务端需用该 code 向 GitHub 令牌端点发起 POST 请求，换取 access_token。但许多 Go 开发者会遇到返回 404 {"error":"Not Found"} 的问题——这并非 URL 错误或网络问题，而是请求体未被正确序列化为有效 JSON。
根本原因在于：Go 的 json 包仅能编码首字母大写的、可导出（exported）字段。原代码中 param 结构体字段全为小写（如 code, client_id），导致 goreq 序列化后生成空 JSON 对象 {}，而 GitHub 服务器无法解析无效请求体，直接返回 404（语义上等价于“找不到符合预期参数的资源”）。
✅ 正确做法是定义带 JSON 标签的导出结构体：
type githubOAuthTokenReq struct {
Code string `json:"code"`
ClientID string `json:"client_id"`
ClientSecret string `json:"client_secret"`
// 注意：GitHub 文档要求 client_id 和 client_secret 作为表单参数（application/x-www-form-urlencoded）
// 但其 API 同时支持 JSON body（需显式设置 Content-Type），此处按 JSON 方式演示
}同时，强烈建议改用标准库 net/http 或更现代的 HTTP 客户端（如 github.com/google/go-querystring + net/http），因为 goreq 已归档且不活跃。以下是使用 net/http 的健壮实现示例：
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"net/url"
)
type githubTokenResp struct {
AccessToken string `json:"access_token"`
TokenType string `json:"token_type"`
Scope string `json:"scope"`
}
func getGitHubAccessToken(code, clientID, clientSecret string) (string, error) {
// 构建请求体（JSON 格式）
reqBody := map[string]string{
"code": code,
"client_id": clientID,
"client_secret": clientSecret,
}
jsonData, err := json.Marshal(reqBody)
if err != nil {
return "", fmt.Errorf("marshal request body: %w", err)
}
// 发起 POST 请求
resp, err := http.Post(
"https://github.com/login/oauth/access_token",
"application/json",
bytes.NewBuffer(jsonData),
)
if err != nil {
return "", fmt.Errorf("HTTP request failed: %w", err)
}
defer resp.Body.Close()
// 读取响应
body, err := io.ReadAll(resp.Body)
if err != nil {
return "", fmt.Errorf("read response body: %w", err)
}
// GitHub 返回的是 application/json，但含原始文本参数（如 access_token=xxx&scope=...）
// ⚠️ 注意：GitHub 实际推荐使用 application/x-www-form-urlencoded！
// 若坚持用 JSON，请确保 Accept 头为 application/json；但更稳妥方式是解析 query string：
if resp.StatusCode != http.StatusOK {
return "", fmt.Errorf("GitHub API error: %s (%d)", string(body), resp.StatusCode)
}
// 解析 GitHub 返回的 URL 编码响应（例如：access_token=abc123&scope=user&token_type=bearer）
values, err := url.ParseQuery(string(body))
if err != nil {
return "", fmt.Errorf("parse response as query: %w", err)
}
if token, ok := values["access_token"]; ok && len(token) > 0 {
return token[0], nil
}
return "", fmt.Errorf("no access_token in response: %s", string(body))
}
func main() {
// 替换为你的实际值（切勿硬编码到生产代码！）
code := "YOUR_AUTH_CODE"
clientID := "YOUR_CLIENT_ID"
clientSecret := "YOUR_CLIENT_SECRET"
token, err := getGitHubAccessToken(code, clientID, clientSecret)
if err != nil {
fmt.Printf("Error: %v\n", err)
return
}
fmt.Printf("Access Token: %s\n", token)
}? 关键注意事项：
- ✅ 字段必须首字母大写 + json tag，否则 JSON 序列化为空；
- ✅ GitHub 令牌接口官方文档明确推荐使用 application/x-www-form-urlencoded，而非 JSON（尽管 JSON 在部分版本中兼容）。生产环境建议用 url.Values{}.Encode() 构造请求体；
- ✅ 务必检查 resp.StatusCode，不要忽略 4xx/5xx 响应；
- ✅ client_secret 属于敏感凭据，严禁硬编码或提交至版本库；应通过环境变量或密钥管理服务注入；
- ✅ 使用 context.Context 控制超时（如 http.NewRequestWithContext），避免请求无限挂起。
遵循以上规范，即可稳定完成 GitHub OAuth 的服务端令牌交换流程。
