不使用discord.py如何用Python通过用户ID获取Discord用户pfp链接及替代库

核心实现逻辑 #

Discord的用户头像是托管在官方静态CDN上的可访问资源，要获取对应链接，根本不需要重型Bot框架的网关连接、事件循环组件，只要通过纯HTTP请求拉取公开用户信息，再按固定规则拼接CDN地址就能完成，完全可以绕开discord.py的依赖。

可选替代实现路径 #

• 直连接口轻量方案：仅使用Python基础的requests库，搭配有效的Discord Bot鉴权Token调用官方公开用户接口，拿到头像哈希值后按规则拼接链接，无任何重型框架依赖，适合对包体积、运行效率有要求的场景。
• 轻量封装库方案：选择仅做HTTP接口封装的Discord Python工具库，这类库不内嵌discord.py的网关事件组件，仅提供静态接口调用能力，可以省去手动写鉴权头、处理默认头像规则的重复代码。

可直接运行的参考代码 #

import requests

def fetch_discord_avatar_url(user_id: str, valid_bot_token: str) -> str:
    # 构造接口请求头，完成鉴权
    request_headers = {"Authorization": f"Bot {valid_bot_token}"}
    # 调用版本稳定的v10接口获取目标用户公开信息
    user_resp = requests.get(
        f"https://discord.com/api/v10/users/{user_id}",
        headers=request_headers,
        timeout=10
    )
    user_resp.raise_for_status()
    user_info = user_resp.json()
    
    # 处理用户未设置自定义头像的默认场景
    custom_avatar_hash = user_info.get("avatar")
    if not custom_avatar_hash:
        discriminator = int(user_info["discriminator"])
        return f"https://cdn.discordapp.com/embed/avatars/{discriminator % 5}.png"
    
    # 拼接自定义头像的可直接访问链接，可通过size参数调整输出分辨率
    return f"https://cdn.discordapp.com/avatars/{user_id}/{custom_avatar_hash}.png?size=512"

注意：Discord官方接口要求所有用户信息查询请求必须携带有效Bot Token做鉴权，无Token的情况下无法仅通过用户ID拉取对应账号的头像哈希值，请求过频还会触发接口限流甚至IP封禁。

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