Windows环境调用带附件默认Thunderbird邮件客户端失败问题求助

已尝试方案失效原因 #

• mailto:协议本身无附件相关规范定义，所有通过Start-Process、webbrowser模块直接调用mailto链接的方案，都会被邮件客户端自动忽略非标的attachment参数，只能打开邮件窗口、填充主题正文，无法挂载附件。
• 参考的C#反射MAPI方案抛出空引用异常，是因为该方案依赖Outlook注册的专属MAPI组件，当前默认客户端为Thunderbird时，对应的构造函数对象未注册，mailWriterContructor为null，调用Invoke方法自然触发空引用错误，该方案仅适配Outlook，不具备通用性。
• 网上流传的通用Python启动默认邮件客户端方案基本都基于mailto协议实现，天生不支持附件挂载，无法满足需求。

可直接运行的通用实现 #

该方案基于Windows原生Simple MAPI接口实现，无需安装额外邮件客户端SDK，可自动唤起系统默认邮件客户端，预填收件人、主题、正文，同时正确挂载附件，适配Thunderbird、Outlook、Foxmail等所有在Windows注册MAPI接口的邮件客户端。

1. 先安装依赖：
   pip install pywin32
2. 功能代码：

import os
import win32com.client

def open_default_mail_client(to: str, subject: str, body: str, attachments: list[str] | None = None):
    """
    唤起Windows默认邮件客户端并预填内容
    :param to: 收件人邮箱，多个收件人用分号分隔
    :param subject: 邮件主题
    :param body: 邮件正文
    :param attachments: 附件绝对路径列表
    """
    mapi_session = win32com.client.Dispatch("MAPI.Session")
    mapi_session.Logon()
    new_mail = mapi_session.Outbox.Messages.Add()
    new_mail.Subject = subject
    new_mail.Text = body

    if to:
        recip = new_mail.Recipients.Add()
        recip.Address = to
        recip.Resolve()

    if attachments:
        for attach_path in attachments:
            # 仅挂载存在的绝对路径文件
            if os.path.isabs(attach_path) and os.path.exists(attach_path):
                new_mail.Attachments.Add(attach_path)
    
    # 弹出邮件编辑窗口，不自动发送
    new_mail.Display()

# 测试调用
if __name__ == "__main__":
    # 注意附件必须传绝对路径，不要用相对路径
    test_attachment = os.path.abspath("cost example.xlsx")
    open_default_mail_client(
        to="some.guy@someplace.com",
        subject="an email",
        body="see attachment",
        attachments=[test_attachment]
    )

Thunderbird适配注意事项 #

如果运行代码后附件未正常挂载，按以下步骤检查：

• 打开Thunderbird设置-常规页面，拉到底部确认Thunderbird已被设置为系统默认邮件客户端，且已注册MAPI接口，便携版Thunderbird不会自动注册MAPI，更换为正式安装版即可正常调用。
• 传入的附件路径不要包含特殊转义字符，路径长度不要超过Windows系统限制。

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