脚本中邮件发送附件如何实现

wen 实用脚本 2026-07-21 1

自动化邮件附件的完整实现方案

📖 目录导读

邮件附件的核心机制 – 理解SMTP、MIME与附件编码
Python实现方案 – 使用smtplib与email库发送带附件的邮件
Shell脚本方案 – 利用mailx、mutt或sendmail命令行工具
PowerShell脚本方案 – Windows环境下的附件发送
常见问题与FAQ – 附件大小限制、编码错误、认证失败解决方案
SEO优化与最佳实践 – 日志记录、错误重试、安全配置

邮件附件的核心机制：SMTP与MIME

在脚本中实现邮件发送附件，本质是通过SMTP协议将二进制文件编码为Base64或Quoted-Printable格式，并封装在MIME消息中，MIME（多用途互联网邮件扩展）定义了如何将非文本内容（如PDF、图片、压缩包）嵌入邮件。

脚本中邮件发送附件如何实现

关键组件

Content-Type：标识附件类型（如application/pdf）
Content-Disposition：声明附件名为attachment; filename="report.pdf"
Base64编码：将二进制文件转换为ASCII文本，减少传输失败

常见误区

直接在邮件正文中粘贴文件内容（会导致乱码）
未正确处理文件路径中的中文或空格

Python脚本实现：最灵活、最广泛使用的方式

Python的smtplib和email标准库是跨平台发送附件的首选,以下是生产级代码示例：

import smtplib
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email.mime.text import MIMEText
from email import encoders
def send_email_with_attachment(smtp_server, port, sender, password, receivers, subject, body, file_path):
    # 创建混合消息容器
    msg = MIMEMultipart()
    msg['From'] = sender
    msg['To'] = ", ".join(receivers)
    msg['Subject'] = subject
    # 添加正文
    msg.attach(MIMEText(body, 'plain', 'utf-8'))
    # 处理附件
    try:
        with open(file_path, 'rb') as attachment:
            part = MIMEBase('application', 'octet-stream')
            part.set_payload(attachment.read())
            encoders.encode_base64(part)  # 自动Base64编码
            part.add_header(
                'Content-Disposition',
                f'attachment; filename= {file_path.split("/")[-1]}'
            )
            msg.attach(part)
    except FileNotFoundError:
        print(f"附件文件不存在: {file_path}")
        return False
    # 发送邮件
    try:
        if port == 465:
            server = smtplib.SMTP_SSL(smtp_server, port)
        else:
            server = smtplib.SMTP(smtp_server, port)
            server.starttls()
        server.login(sender, password)
        server.send_message(msg)
        server.quit()
        print("邮件发送成功")
        return True
    except smtplib.SMTPAuthenticationError:
        print("认证失败，请检查用户名/密码或开启SMTP服务")
    except smtplib.SMTPException as e:
        print(f"SMTP错误: {e}")
    return False
# 使用示例
send_email_with_attachment(
    "smtp.gmail.com", 587,
    "your-email@gmail.com", "app-password",
    ["receiver@example.com"],
    "月度报告", "请查收附件中的报表",
    "/home/user/report.pdf"
)

关键细节

使用Gmail需开启“应用专用密码”或允许不安全应用访问
附件超过25MB时需调整发送方限制（如Gmail限制25MB）
中文文件名需使用Header编码避免乱码

Shell脚本实现：Linux/Unix环境下的轻量级方案

方案A：使用`mailx`（主流发行版内置）

#!/bin/bash
# 安装：apt install bsd-mailx 或 yum install mailx
echo "邮件正文" | mailx -s "主题" \
  -a /home/user/附件.pdf \
  -a /home/user/图片.png \
  -r sender@example.com \
  receiver@example.com

优点：一行命令，支持多个附件
缺点：无法直接控制SMTP认证（需依赖系统MTA）

方案B：使用`mutt`（更强大，支持SMTP直接认证）

#!/bin/bash
# mutt -x 表示允许二进制附件
echo "正文" | mutt -s "主题" \
  -a /home/user/report.zip \
  -c cc@example.com \
  -- receiver@example.com

配置SMTP：在~/.muttrc中设置：

set smtp_url="smtps://username@app密码@smtp.gmail.com:465/"

方案C：纯bash + `curl`（无需额外软件）

#!/bin/bash
# 使用curl发送SMTP，手动构建MIME消息
(
echo "From: sender@example.com"
echo "To: receiver@example.com"
echo "Subject: 测试附件"
echo "MIME-Version: 1.0"
echo "Content-Type: multipart/mixed; boundary=\"BOUNDARY\""
echo ""
echo "--BOUNDARY"
echo "Content-Type: text/plain"
echo ""
echo "请看附件"
echo ""
echo "--BOUNDARY"
echo "Content-Type: application/pdf"
echo "Content-Disposition: attachment; filename=\"report.pdf\""
echo "Content-Transfer-Encoding: base64"
echo ""
base64 /home/user/report.pdf
echo ""
echo "--BOUNDARY--"
) | curl --mail-from sender@example.com \
    --mail-rcpt receiver@example.com \
    --ssl-reqd \
    -u "username:password" \
    -T - \
    "smtps://smtp.gmail.com:465"

PowerShell脚本实现：Windows环境原生方案

# 需要 .NET SmtpClient (Windows默认支持)
$smtpServer = "smtp.gmail.com"
$smtpPort = 587
$username = "sender@gmail.com"
$password = "app-password"
$to = "receiver@example.com"
$subject = "报告"
$body = "附件请查收"
$attachmentPath = "C:\Reports\report.pdf"
$smtp = New-Object Net.Mail.SmtpClient($smtpServer, $smtpPort)
$smtp.EnableSsl = $true
$smtp.Credentials = New-Object System.Net.NetworkCredential($username, $password)
$message = New-Object Net.Mail.MailMessage($username, $to, $subject, $body)
$attachment = New-Object Net.Mail.Attachment($attachmentPath)
$message.Attachments.Add($attachment)
try {
    $smtp.Send($message)
    Write-Host "邮件发送成功"
}
catch {
    Write-Host "错误: $_"
}
finally {
    $message.Dispose()
    $attachment.Dispose()
    $smtp.Dispose()
}

注意事项

需在PowerShell执行策略中允许脚本（Set-ExecutionPolicy RemoteSigned）
国际字符集需设置$message.BodyEncoding = [System.Text.Encoding]::UTF8

常见问题与FAQ

Q1：附件发送后变成“ATT00001.bin”怎么办？

A：这是MIME类型不匹配引起的，确保设置正确的Content-Type，

PDF：application/pdf
ZIP：application/zip
Excel：application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Q2：如何发送超过25MB的大附件？

A：使用云存储方案（如Google Drive链接）或分片压缩（zip -s 20m），SMTP协议本身不限制大小，但供应商有限制（Gmail 25MB，Outlook 20MB）。

Q3：发送带中文文件名的附件乱码？

A：Python中需对文件名进行Base64编码：

from email.header import Header
part.add_header('Content-Disposition', 'attachment',
                filename=Header('中文文件.pdf', 'utf-8').encode())

Q4：Gmail发送失败提示“Application-specific password required”？

A：需在Google账户安全设置中生成“应用专用密码”；或开启“允许低安全应用”（不建议）。

Q5：如何实现循环发送多个附件？

A：Python中使用for file in file_list:逐个attach；Shell脚本mailx可用多个-a参数。

SEO优化与最佳实践

错误重试：在脚本中加入指数退避重试机制
日志记录：记录每次发送的附件名称、大小、收件人、发送状态（推荐JSON格式）
安全性：不要在脚本中硬编码密码，使用环境变量或密钥管理服务（如Hashicorp Vault）
性能：大附件可先压缩为ZIP再发送，同时减少SMTP连接数

代码优化示例（Python重试逻辑）

import time
from functools import wraps
def retry(max_attempts=3, delay=2):
    def decorator(func):
        @wraps(func)
        def wrapper(*args, **kwargs):
            for attempt in range(1, max_attempts+1):
                try:
                    return func(*args, **kwargs)
                except Exception as e:
                    print(f"尝试{attempt}失败: {e}")
                    time.sleep(delay * attempt)
            raise Exception("所有重试均失败")
        return wrapper
    return decorator
@retry(max_attempts=3)
def send_attachment_mail(...):
    # 发送代码同上

通过以上方案，您可以在Python、Shell、PowerShell等主流脚本语言中灵活实现邮件附件发送，实际生产环境建议优先使用带重试机制的Python脚本，结合环境变量配置和完善的日志记录，可满足95%以上的自动化场景需求，对于需要高可靠性的任务（如财务报表发送），可进一步集成消息队列（RabbitMQ）或定时任务调度器（Airflow）。