如何通过 GitHub API 安全合规地获取用户邮箱地址-Python教程-PHP中文网

如何通过 GitHub API 安全合规地获取用户邮箱地址

GitHub API 默认不返回用户邮箱，即使使用有效 Token，也仅当用户主动公开邮箱且 Token 拥有 user:email 权限时才可能获取；直接调用 user.email 字段常返回 None，需改用 /user/emails 端点并显式请求。

github api 默认不返回用户邮箱，即使使用有效 token，也仅当用户主动公开邮箱且 token 拥有 `user:email` 权限时才可能获取；直接调用 `user.email` 字段常返回 `none`，需改用 `/user/emails` 端点并显式请求。

在 GitHub 生态中，用户邮箱地址属于敏感隐私数据，API 设计严格遵循最小权限与隐私保护原则。默认情况下，无论是通过 GET /users/{username}（即 g.get_user()）还是 Issue 相关资源，email 字段均不会返回真实值——即使用户存在、Token 有效，结果也几乎总是 None 或空字符串。

✅ 正确做法：使用 /user/emails 端点 + 显式权限

要获取当前认证用户自身的邮箱（例如用于审计或通知），必须：

确保 Personal Access Token 已授权 user:email 范围（在 GitHub Settings → Developer settings → Personal access tokens 中勾选）；
调用 GET /user/emails 接口（对应 PyGithub 的 g.get_user().get_emails()），该接口返回用户所有已验证邮箱列表，并标注主邮箱（primary: true）和可见性（visibility: 'public' | 'private' | 'limited'）；
注意：此接口仅返回 当前 Token 所属用户 的邮箱，无法跨账户获取他人邮箱（GitHub 明确禁止）。

以下为修正后的 Python 示例（基于 PyGithub>=1.57）：

from github import Github
from typing import List, Dict, Optional

def extract_issues_with_emails(repo_url: str, access_token: str) -> Optional[List[Dict]]:
    try:
        g = Github(access_token)

        # 解析仓库路径
        repo_path = repo_url.strip('/').split('/')[-2:]
        if len(repo_path) <h3>⚠️ 关键注意事项</h3>

无法获取他人邮箱：GitHub API 明确禁止通过任何方式（包括 Issue、PR、Commit、User API）获取非当前认证用户的邮箱。这是平台强制策略，与 Token 权限无关。
user:email 权限仅作用于自身：该 scope 仅允许读取 你自己的 邮箱列表，不赋予跨账户访问能力。
公开邮箱 ≠ API 可见：即使用户在个人资料页设置了“Public email”，GitHub 仍可能因隐私设置（如 “Keep my email address private”）阻止 API 返回。
合规建议：
- 若业务需联系贡献者，请优先使用 GitHub 的 @mention 或 Issue/PR 评论机制；
- 如需批量通信，应引导用户主动订阅或通过组织级 OAuth App 获取明确授权；
- 切勿尝试爬虫、伪造请求或滥用 API 绕过限制——违反 GitHub API Terms 可能导致 Token 封禁或账户终止。