为什么需要获取用户ID？
在Telegram机器人开发中，用户ID是识别用户身份的唯一标识。无论是记录用户行为、发送定向通知，还是实现白名单机制，都需要从对话中提取用户ID。本文将从实战角度，为你剖析机器人获取对话双方用户ID的几种方法，并给出可直接运行的代码。
基础概念：User对象与Chat对象
Telegram Bot API中，User对象代表一个用户或机器人，包含id、first_name等字段；Chat对象代表一个对话（私聊、群组、频道），也有自己的id。在私聊中，Chat.id通常等于用户的ID，但要注意在群组中Chat.id是负数，需要区分。
方案一：从Message对象中直接提取（最常用）
机器人收到的每条消息都是一个Message对象，其中包含发送者的信息。以下是Python示例（使用python-telegram-bot库）：
from telegram import Update
from telegram.ext import Application, MessageHandler, filters
async def handle_message(update: Update, context):
message = update.message
user = message.from_user
chat = message.chat
# 发送者ID
user_id = user.id
# 如果是私聊，chat.id 等于 user_id；群聊中则不同
chat_id = chat.id
print(f"User ID: ")
print(f"Chat ID: ")
# 如果是回复消息，还可以获取被回复者的ID
if message.reply_to_message and message.reply_to_message.from_user:
replied_user_id = message.reply_to_message.from_user.id
print(f"Replied User ID: ")
await message.reply_text(f"你的ID是 ")
app = Application.builder().token("YOUR_TOKEN").build()
app.add_handler(MessageHandler(filters.ALL, handle_message))
app.run_polling()这种方法适用于机器人接收到任何消息的场景，包括私聊和群组消息。在群组中，如果成员发送消息，你可以通过message.from_user.id获取发送者的用户ID。
方案二：从ChatMemberUpdated更新中获取
当用户加入群组、离开群组、被提升为管理员或权限发生变化时，机器人会收到my_chat_member或chat_member更新。这些更新中包含完整的用户信息，即使对方从没发过消息也能获取。
from telegram import Update
from telegram.ext import Application, ChatMemberHandler
async def track_members(update: Update, context):
if update.chat_member:
member = update.chat_member.new_chat_member
user = member.user
print(f"用户ID: {user.id}")
print(f"用户名: {user.username}")
print(f"状态: {member.status}")
app = Application.builder().token("YOUR_TOKEN").build()
app.add_handler(ChatMemberHandler(track_members, ChatMemberHandler.CHAT_MEMBER))
app.run_polling()这一方案特别适合群组管理机器人，可以建立成员名单数据库。
方案三：主动请求Chat成员列表
如果你的机器人是群组管理员，可以使用getChatAdministrators或getChatMember方法主动查询指定用户信息。通过getChat方法还可以获取群组的基础信息。
import asyncio
from telegram import Bot
async def get_user_info():
bot = Bot(token="YOUR_TOKEN")
# 假设已知群组chat_id和用户ID
chat_id = -1001234567890
user_id = 123456789
member = await bot.get_chat_member(chat_id=chat_id, user_id=user_id)
print(f"用户ID: {member.user.id}")
print(f"用户名: {member.user.username}")
asyncio.run(get_user_info())如果需要获取所有管理员，可以使用get_chat_administrators，它会返回管理员列表，每个管理员的user对象就是用户信息。
获取“对话中双方”的ID：私聊与群组场景
所谓“双方”，通常指：
1. 用户（发送者）
2. 机器人自己（可通过context.bot.id获取）
或者私聊中的另一位参与者。因为私聊就是一对一的，message.chat.id就是对方的用户ID。在群组中，你也可以通过message.from_user和message.reply_to_message.from_user来获取互动双方的ID。
实战案例：记录用户ID并发送欢迎语
这里给出一个完整的机器人示例，当新成员加入时，记录其ID并发送欢迎消息：
from telegram import Update
from telegram.ext import Application, ChatMemberHandler, ContextTypes
async def welcome(update: Update, context: ContextTypes.DEFAULT_TYPE):
if update.chat_member:
new_status = update.chat_member.new_chat_member.status
if new_status == "member" or new_status == "administrator":
user = update.chat_member.new_chat_member.user
chat_id = update.chat_member.chat.id
# 存储ID到数据库或文件
with open("user_ids.txt", "a") as f:
f.write(f"{user.id}\n")
await context.bot.send_message(chat_id, f"欢迎 {user.first_name}！你的用户ID是 {user.id}")
app = Application.builder().token("YOUR_TOKEN").build()
app.add_handler(ChatMemberHandler(welcome, ChatMemberHandler.CHAT_MEMBER))
app.run_polling()常见坑与最佳实践
- 群组Chat.id是负数：不要将群组Chat.id当作用户ID，避免类型混乱。
- User对象可能为None：频道帖子中发送者是关联的频道，不是普通用户。
- 隐私设置：如果用户设置了隐私模式，机器人无法在群组中看到其他成员的消息，但
from_user仍然可用（因为是发送者），此时需要通过chat_member更新获取其他成员。 - 不要信任用户名：用户名可以修改，用户ID才是稳定的标识。
- 存储安全：用户ID属于敏感信息，建议加密存储。
总结
获取对话中的用户ID是Telegram机器人开发的基础技能。你可以根据消息对象、成员更新或主动API请求来获取。实际开发中，建议结合多种方案以确保覆盖所有场景。通过本文的代码示例，你可以快速集成到自己的机器人中，从而构建更强大的用户管理系统。