Telegram Bot生成二维码图片并发送的代码详解：从文本到可扫描图像

在进行Telegram Bot开发时，经常会遇到需要动态生成二维码并发送给用户的场景，例如用于登录验证、支付链接或事件签到。本文将从零开始，详细讲解如何调用第三方二维码生成库，结合Telegram Bot API将图片发送给用户。无论你使用Python还是Node.js，都能找到对应的实现方案。

一、实现原理与准备工作

Telegram Bot本身不包含二维码生成能力，因此我们需要借助外部库或API生成二维码图片。整体流程为：

1. 接收用户输入（如文本URL或任意字符串）；
2. 调用二维码生成库（如Python的qrcode或Node.js的qrcode）生成图片数据；
3. 将图片数据通过Telegram Bot API的sendPhoto或sendDocument方法发送给用户。

在开始之前，请确保你已拥有一个Bot Token，并且安装了对应的HTTP客户端库（如Python的requests或Node.js的axios）。

二、Python实现：使用qrcode库生成并发送

1. 安装依赖

pip install qrcode[pil] requests

这里使用qrcode库生成图片，并使用requests调用Telegram API。

2. 生成二维码图片并保存为文件

import qrcode

# 用户输入的内容
content = "https://t.me/some_reference"

# 生成二维码图片
qr = qrcode.QRCode(
    version=1,
    error_correction=qrcode.constants.ERROR_CORRECT_L,
    box_size=10,
    border=4,
)
qr.add_data(content)
qr.make(fit=True)

img = qr.make_image(fill_color="black", back_color="white")
img.save("qr.png")

3. 调用Bot API发送图片

import requests

TOKEN = "YOUR_BOT_TOKEN"
CHAT_ID = "USER_CHAT_ID"  # 可以是群组ID或用户ID

url = f"https://api.telegram.org/bot/sendPhoto"
files = {"photo": open("qr.png", "rb")}
data = {"chat_id": CHAT_ID, "caption": "这是您的二维码"}
response = requests.post(url, files=files, data=data)
print(response.json())

4. 内联发送（不落盘）

如果不想保存临时文件，可以直接使用BytesIO操作内存数据：

import qrcode
from io import BytesIO
import requests

# 生成二维码并保存到内存
img = qrcode.make("Hello World")
buffer = BytesIO()
img.save(buffer, format="PNG")
buffer.seek(0)

# 发送
url = f"https://api.telegram.org/bot/sendPhoto"
files = {"photo": buffer}
data = {"chat_id": CHAT_ID}
requests.post(url, files=files, data=data)

三、Node.js实现：使用qrcode库并上传

1. 安装依赖

npm install qrcode axios

2. 生成二维码并发送（基于Promise）

const QRCode = require('qrcode');
const axios = require('axios');

const TOKEN = 'YOUR_BOT_TOKEN';
const CHAT_ID = 'USER_CHAT_ID';

// 生成二维码为Data URL
QRCode.toDataURL('https://t.me/your_link')
  .then(url => {
    // 将Data URL转换为Buffer
    const base64Data = url.replace(/^data:image\/png;base64,/, '');
    const buffer = Buffer.from(base64Data, 'base64');

    // 使用FormData发送
    const formData = new FormData();
    formData.append('chat_id', CHAT_ID);
    formData.append('photo', buffer, 'qr.png');

    return axios.post(`https://api.telegram.org/bot$/sendPhoto`, formData, {
      headers: { 'Content-Type': 'multipart/form-data' }
    });
  })
  .then(res => console.log(res.data))
  .catch(err => console.error(err));

四、发送二维码作为文档的备选方案

有些场景下我们希望用户能够下载原始图片，而不是在聊天中直接预览。可以使用sendDocument方法，区别只是在API端点与参数名上：

# Python示例：发送为文档
files = {"document": open("qr.png", "rb")}
url = f"https://api.telegram.org/bot/sendDocument"
requests.post(url, files=files, data={"chat_id": CHAT_ID})

五、处理高并发与性能优化

1. 缓存二维码

如果同一个内容被频繁请求，可以生成一次并缓存图片文件ID，下次直接使用sendPhoto的photo参数传递文件ID，避免重复生成和上传。

2. 限制图片尺寸与错误修正级别

对于长URL，建议设置error_correction为ERROR_CORRECT_Q或ERROR_CORRECT_H，并在box_size上进行调节，以平衡清晰度与图片大小。

3. 使用异步框架

在Bot框架中（如python-telegram-bot或Telegraf），应将二维码生成和发送操作放入异步任务或使用线程池，避免阻塞事件循环。

六、常见问题与解决方案

Q: 生成的二维码无法被扫描？

确保内容正确且无多余字符，并适当提高错误修正级别。另外，不要使用过小的box_size（建议不小于5）。

Q: 发送图片时遇到“photo file is too large”？

Telegram限制图片大小不超过5MB，一般二维码不会超限。若仍报错，可压缩图片或改用sendDocument（文档限制为50MB）。

Q: 如何动态生成彩色二维码？

在Python中可通过fill_color参数设置前景色，但注意颜色对比度必须足够。

七、完整示例：一键发送带Logo的二维码

将Logo嵌入二维码中心，需要额外的图像处理。这里以Python为例：

from PIL import Image
import qrcode

qr = qrcode.QRCode(error_correction=qrcode.constants.ERROR_CORRECT_H)
qr.add_data("https://t.me/your_channel")
qr.make()
img = qr.make_image().convert('RGB')

logo = Image.open('logo.png')
logo = logo.resize((60, 60))
pos = ((img.size[0] - logo.size[0]) // 2, (img.size[1] - logo.size[1]) // 2)
img.paste(logo, pos)
img.save('qr_logo.png')

总结

本文详细阐述了Telegram Bot生成二维码图片并发送的完整流程，包括Python和Node.js两种主流实现。核心要点在于：合理选择二维码库、正确构造API请求、优化性能与缓存。掌握这些技巧后，你可以将二维码功能无缝集成到签到、认证、导流等业务场景中，提升Bot的实用性与用户交互体验。

记住，在实际部署时，务必处理好异常情况（如网络超时、API限制），并为Bot添加适当的日志记录，便于排查问题。希望本文能成为你开发路上的实用参考。