Python生成的二维码扫码后收件人邮箱未显示问题排查

我编写了如下Python脚本，用于生成包含预设收件人邮箱的mailto二维码。该脚本其他功能均正常，但扫码后邮件的「收件人」字段未显示指定邮箱，附上脚本及生成的二维码图片，求排查原因。

import qrcode
import os
import urllib.parse

# 定义mailto URL组件
recipient = "my.email@example.com"
subject = "故障报告"
body = "机器坏了，急需帮助！"

# 编码主题和正文
subject_encoded = urllib.parse.quote(subject)
body_encoded = urllib.parse.quote(body)

# 构建mailto URL
mailto_url = f"mailto:{recipient}?subject={subject_encoded}&body={body_encoded}"

# 打印mailto URL用于调试
print(f"Mailto URL: {mailto_url}")

# 创建二维码
qr = qrcode.QRCode(
    version=1,
    error_correction=qrcode.constants.ERROR_CORRECT_L,
    box_size=10,
    border=4,
)
qr.add_data(mailto_url)
qr.make(fit=True)

# 从二维码实例生成图片
img = qr.make_image(fill='black', back_color='white')

# 保存图片到文件
filename = "故障报告二维码.png"
current_directory = os.getcwd()
file_path = os.path.join(current_directory, filename)

print(f"当前目录: {current_directory}")
print(f"保存路径: {file_path}")

img.save(file_path)

print(f"二维码已生成并保存为 {filename}")

该脚本旨在生成供用户扫码提交故障报告的二维码，扫码后应自动填充预设收件人邮箱、主题及正文。

排查思路与解决方案 #

1. 验证mailto URL本身的有效性

运行脚本后，复制控制台输出的Mailto URL，直接粘贴到浏览器地址栏并回车，观察邮件客户端是否能正确唤起并填充收件人。如果这一步正常，说明URL格式没问题，问题出在二维码生成或扫码环节。

2. 检查二维码存储的实际数据

使用在线二维码解析工具扫描生成的图片，对比解析出的URL和脚本打印的内容是否完全一致。若存在差异，可能是二维码生成时出现数据截断：

• 可以尝试去掉QRCode初始化时的version=1参数，让库自动适配合适的二维码版本（虽然当前URL长度很短，版本1足够容纳，但自动适配能避免手动设置的潜在问题）。

3. 排除邮箱格式的兼容性问题

部分邮件客户端对带点号的邮箱（如my.email@example.com）解析可能存在异常，可临时将收件人改为更简单的格式（如test@example.com），重新生成二维码测试。

4. 简化URL逐步排查

先生成仅包含收件人的极简mailto二维码：

mailto_url = f"mailto:{recipient}"

如果扫码后收件人正常显示，再逐步添加subject和body参数，定位是哪个部分导致的解析异常。

内容的提问来源于stack exchange，提问作者Sebastian Kihlberg