Discord用户头像链接的动态获取与持久化策略

import discord

# 初始化Discord客户端，需要设置合适的Intents
# discord.Intents.default() 包含了大部分常见操作所需的Intents
# 如果您的机器人需要访问服务器成员列表等特定信息，可能需要额外启用
# intents.members = True
intents = discord.Intents.default()
client = discord.Client(intents=intents)

@client.event
async def on_ready():
    """
    当机器人成功连接到Discord时触发。
    """
    print(f'机器人已登录为: {client.user}')

async def get_latest_user_avatar_url(user_id: int) -> str | None:
    """
    根据用户ID获取其最新的Discord头像URL。

    参数:
        user_id (int): 目标Discord用户的ID。

    返回:
        str | None: 用户最新头像的CDN链接，如果用户不存在或发生错误则返回None。
    """
    try:
        # 尝试从客户端的缓存中获取用户对象
        # 如果用户不在缓存中，则通过API从Discord服务器获取
        user = client.get_user(user_id)
        if not user:
            user = await client.fetch_user(user_id)

        if user:
            # user.avatar 属性返回一个 Asset 对象，它有一个 .url 属性
            # 该属性会返回用户当前头像的最新CDN链接。
            # 您还可以通过 .with_size() 和 .with_format() 方法调整图片尺寸和格式。
            # 例如：user.avatar.with_size(128).url
            if user.avatar:
                return user.avatar.url
            else:
                # 如果用户没有自定义头像，则返回其默认头像的URL
                return user.default_avatar.url
        else:
            print(f"用户ID为 {user_id} 的用户未找到。")
            return None
    except discord.NotFound:
        print(f"Discord API未找到用户ID为 {user_id} 的用户。")
        return None
    except discord.HTTPException as e:
        print(f"获取用户头像时发生HTTP错误: {e}")
        return None
    except Exception as e:
        print(f"获取用户头像时发生未知错误: {e}")
        return None

# 示例用法：
async def main_example():
    # 替换为你要查询的实际Discord用户ID
    # 例如，可以是您自己的用户ID或其他公开的用户ID
    target_user_id = 123456789012345678 # 请替换为真实的Discord用户ID

    avatar_url = await get_latest_user_avatar_url(target_user_id)
    if avatar_url:
        print(f"用户 {target_user_id} 的最新头像URL: {avatar_url}")
    else:
        print(f"未能获取用户 {target_user_id} 的头像URL。")

# 运行机器人客户端
# 在实际应用中，您需要将 "YOUR_BOT_TOKEN" 替换为您的机器人Token
# 建议将Token存储在环境变量中，而不是直接写在代码里
# client.run("YOUR_BOT_TOKEN")

# 为了演示，我们可以模拟一个简单的运行环境来调用 main_example
import asyncio
async def run_example():
    # 假设机器人已经登录并准备就绪
    # 在实际应用中，client.run() 会处理登录和事件循环
    # 这里我们手动设置 client.user 以模拟登录状态
    client._connection.user = discord.Object(id=client.user.id if client.user else 0) # 模拟一个用户对象
    client._connection.user.name = "MockBot"
    await main_example()

# 如果您在一个脚本中运行，可以这样调用：
# if __name__ == "__main__":
#     # ⚠️ 注意：在实际机器人中，client.run() 会阻塞，
#     # 并且会在内部处理事件循环和 on_ready 事件。
#     # 这里的 run_example 只是为了演示 get_latest_user_avatar_url 函数的用法。
#     # 如果要运行一个完整的机器人，请使用 client.run("YOUR_BOT_TOKEN")
#     asyncio.run(run_example())