本教程详细指导如何使用 discord.py 库为您的 discord 机器人创建自定义欢迎消息。内容涵盖 `on_member_join` 事件处理、构建包含用户头像缩略图和随机本地图片的嵌入式消息（embed），并解决常见的 `attributeerror`。同时，文章还将提供完整的代码示例和重要注意事项，帮助开发者高效实现新成员加入通知功能。
引言：构建 Discord 机器人欢迎功能
在 Discord 机器人开发中，为新加入服务器的成员发送欢迎消息是一个常见且实用的功能，可以提升用户体验并引导新成员快速融入社区。本教程将深入探讨如何利用 Discord.py 库的 on_member_join 事件，结合嵌入式消息（Embed）来创建美观且信息丰富的欢迎通知，包括显示用户头像和随机图片。
核心事件：on_member_join
当有新成员加入服务器时，Discord.py 库会触发 on_member_join 异步事件。您需要在机器人代码中定义一个异步函数来处理此事件。该函数会接收一个 discord.Member 对象作为参数，其中包含了新成员的所有相关信息。
import discord
import os
import random
# 假设 bot 已经初始化并正确设置了 Intents
# intents = discord.Intents.default()
# intents.members = True # 必须启用 members Intent 才能接收 on_member_join 事件
# bot = commands.Bot(command_prefix='!', intents=intents)
@bot.event
async def on_member_join(member):
# 打印新成员信息，便于调试
print(f'新成员加入: 用户名: {member.name}, ID: ({member.id})')
# 定义欢迎频道 ID
welcome_channel_id = 1190887440433557544 # 替换为您的欢迎频道ID
welcome_channel = member.guild.get_channel(welcome_channel_id)
if not welcome_channel:
print('欢迎频道未找到，请检查ID是否正确。')
return
# 进一步的逻辑将在这里实现，例如构建和发送 Embed 消息
# ...重要提示： 为了让机器人能够接收到 on_member_join 事件，您必须在初始化机器人时启用 Intents.members。否则，机器人将无法感知成员加入事件。
构建欢迎嵌入式消息 (Embed)
嵌入式消息（Embed）是 Discord 中一种强大的信息展示方式，它允许您创建结构化、视觉吸引力强的消息。
1. 初始化 Embed
embed = discord.Embed(
title=f'欢迎来到服务器，{member.name}!',
description='我们很高兴您的加入。\n希望您能在这里找到乐趣。',
color=0x3498db # 设置 Embed 的颜色
)2. 添加信息字段
您可以使用 embed.add_field() 方法添加额外的标题和内容区域，例如服务器规则或下一步指南。
embed.add_field(name='服务器规则', value='请严格遵守规则频道中提及的规定。', inline=False)
embed.add_field(name='下一步做什么', value='示例 1, \n示例 2, \n示例 3', inline=False)3. 设置用户头像缩略图
这是本教程的重点之一。许多开发者在尝试获取用户头像 URL 时会遇到 AttributeError。常见的错误尝试包括 member.user.avatar_url 或 member.avatar_url。
问题原因：discord.Member 对象本身并没有 user 或 avatar_url 属性。它有一个 avatar 属性，这个 avatar 属性是一个 discord.Asset 对象，而 discord.Asset 对象才拥有 url 属性。
正确做法： 要获取成员的头像 URL，您应该访问 member.avatar.url。
# 正确设置用户头像为 Embed 缩略图
if member.avatar: # 检查成员是否有自定义头像
embed.set_thumbnail(url=member.avatar.url)
else:
# 如果成员没有自定义头像，可以使用默认头像
# Discord.py 默认头像的获取方式可能因版本而异，这里提供一种常见方式
# 例如：embed.set_thumbnail(url=member.default_avatar.url)
# 或者直接不设置缩略图
print(f'{member.name} 没有自定义头像。')4. 嵌入随机本地图片
除了用户头像，您还可以从本地文件夹中随机选择一张图片并将其嵌入到欢迎消息中。
images_folder = r'Z:\Spooks [Discord Bot]\Images' # 替换为您的图片文件夹路径
image_files = [f for f in os.listdir(images_folder) if f.lower().endswith(('.png', '.jpg', '.jpeg', '.gif', '.bmp', '.webp'))]
if not image_files:
print('图片文件夹中未找到有效图片。')
# 如果没有图片，可以选择不设置图片或使用默认图片
else:
random_image_file = random.choice(image_files)
image_path = os.path.join(images_folder, random_image_file)
# 设置 Embed 的图片。注意，这里使用 attachment:// 前缀
# 告诉 Discord 这张图片将作为附件发送
embed.set_image(url=f'attachment://{random_image_file}')
# 创建 discord.File 对象，用于将本地图片作为附件发送
file = discord.File(image_path, filename=random_image_file)
# 发送消息时需要同时传入 embed 和 file
await welcome_channel.send(embed=embed, file=file)关于图片尺寸：embed.set_image() 方法会显示您提供的图片。如果您希望图片显示为矩形，那么源图片本身就必须是矩形。Discord 的 Embed 系统不会强制将矩形图片裁剪或拉伸为正方形，它会尽可能保持图片的原始宽高比。如果您的图片目前显示为正方形（如 320x320），那是因为您的源文件就是正方形。要显示矩形图片，请提供矩形尺寸的图片文件。
完整示例代码
将上述所有部分整合，构成一个完整的 on_member_join 事件处理器。
import discord
from discord.ext import commands
import os
import random
# 机器人初始化，务必启用 intents.members
intents = discord.Intents.default()
intents.members = True # 必须启用
bot = commands.Bot(command_prefix='!', intents=intents)
@bot.event
async def on_ready():
print(f'{bot.user} 已上线！')
@bot.event
async def on_member_join(member):
print(f'新成员加入: 用户名: {member.name}, ID: ({member.id})')
# 替换为您的欢迎频道 ID
welcome_channel_id = 1190887440433557544
welcome_channel = member.guild.get_channel(welcome_channel_id)
if not welcome_channel:
print('欢迎频道未找到，请检查ID是否正确。')
return
# 初始化 Embed 消息
embed = discord.Embed(
title=f'欢迎来到服务器，{member.name}!',
description='我们很高兴您的加入。\n希望您能在这里找到乐趣。',
color=0x3498db # 蓝色
)
# 添加信息字段
embed.add_field(name='服务器规则', value='请严格遵守规则频道中提及的规定。', inline=False)
embed.add_field(name='下一步做什么', value='示例 1, \n示例 2, \n示例 3', inline=False)
# 设置用户头像缩略图
if member.avatar: # 检查成员是否有自定义头像
embed.set_thumbnail(url=member.avatar.url)
else:
print(f'{member.name} 没有自定义头像。')
# 可以选择使用默认头像或不设置缩略图
# 处理本地随机图片
images_folder = r'Z:\Spooks [Discord Bot]\Images' # 替换为您的图片文件夹路径
file_to_send = None # 初始化为 None
if os.path.exists(images_folder) and os.path.isdir(images_folder):
image_files = [f for f in os.listdir(images_folder) if f.lower().endswith(('.png', '.jpg', '.jpeg', '.gif', '.bmp', '.webp'))]
if not image_files:
print('图片文件夹中未找到有效图片。')
else:
random_image_file = random.choice(image_files)
image_path = os.path.join(images_folder, random_image_file)
# 设置 Embed 的图片，使用 attachment:// 前缀
embed.set_image(url=f'attachment://{random_image_file}')
# 创建 discord.File 对象
file_to_send = discord.File(image_path, filename=random_image_file)
else:
print(f"图片文件夹路径 '{images_folder}' 不存在或不是一个目录。")
# 发送欢迎消息
try:
if file_to_send:
await welcome_channel.send(embed=embed, file=file_to_send)
else:
await welcome_channel.send(embed=embed)
print(f'已向 {member.name} 发送欢迎消息。')
except discord.Forbidden:
print(f'机器人没有权限在 {welcome_channel.name} 频道发送消息。')
except Exception as e:
print(f'发送欢迎消息时发生错误: {e}')
# 运行机器人 (替换为您的机器人 Token)
# bot.run('YOUR_BOT_TOKEN')注意事项与最佳实践
- 启用 Intents.members： 这是接收 on_member_join 事件的关键。在 Discord 开发者门户中，您可能还需要在 Bot 设置页面启用 "PRESENCE INTENT" 和 "SERVER MEMBERS INTENT"。
- 频道 ID 准确性： 确保 welcome_channel_id 是正确的，并且机器人有权限在该频道发送消息。
-
图片路径处理：
- images_folder 应指向您的图片文件夹的绝对路径或相对于机器人脚本的相对路径。
- 在部署机器人时，请确保图片文件夹在服务器上是可访问的。
-
错误处理：
- 始终检查 welcome_channel 是否成功获取，以及图片文件夹中是否有图片。
- 添加 try-except 块来捕获发送消息时可能出现的权限错误或其他异常。
- 异步编程： Discord.py 是一个异步库。所有与 Discord API 交互的操作都应该是 awaitable 的。
- Embed 限制： Discord 对 Embed 的大小和字段数量有一定限制。避免创建过大或字段过多的 Embed。
总结
通过本教程，您应该已经掌握了如何使用 Discord.py 创建一个功能完善的机器人欢迎系统。这包括正确处理 on_member_join 事件，构建包含用户头像和本地图片的嵌入式消息，并解决了常见的 AttributeError。遵循这些指南和最佳实践，您的 Discord 机器人将能提供更友好、更专业的欢迎体验。
