Intel Edison物联网设备邮件通知系统：Python实现与稳定性优化

1. 项目概述：为什么要在Edison上实现邮件通知？

几年前，我在一个工业物联网项目里遇到了一个头疼的问题：几十台部署在偏远厂区的设备，需要实时上报运行状态。网络时好时坏，传统的云平台心跳检测总有延迟，等运维人员发现设备离线，可能故障已经发生几个小时了。当时我们就在想，能不能让设备自己“说话”，在关键事件发生时，比如温度超标、振动异常或者干脆断网前，主动发一封邮件出来？这个需求最终落在了Intel Edison这块小巧的开发板上。

Edison，作为一款集成了Quark处理器和Wi-Fi/蓝牙的微型计算模块，其定位就是物联网的“桥头堡”。它性能足够跑一个轻量级的Linux系统（我们用的是基于Yocto的Ubilinux），又有完整的网络栈，天生就是干“连接”和“边缘计算”的料。在它上面开发发送邮件的程序，远不止是调用一个sendmail命令那么简单。这背后涉及的是如何在资源受限（内存、存储有限）、运行环境可能不稳定（依赖网络）的边缘设备上，构建一个可靠、轻量且易于集成的通知机制。

这个功能的价值在于“主动”和“集成”。你不需要一个始终在线的中心服务器去轮询所有设备，设备成了信息的主动发布者。无论是生产线上的急停报警，温室大棚里的温湿度预警，还是你家树莓派做的NAS完成了大文件下载，一封及时的邮件就能把信息从边缘推送到你眼前。相比于复杂的消息队列（MQTT）或第三方推送服务，邮件协议（SMTP）几乎无处不在，配置直观，对于很多中小型项目或原型验证来说，是性价比最高的通知方案。

接下来，我会拆解在Edison上实现邮件通知的完整路径，从环境准备、协议选择、代码实现到稳定性打磨，分享我踩过的坑和总结的经验。无论你是物联网开发者、创客，还是单纯想给家里的智能硬件加个“嘴巴”，这篇内容都能给你一份可直接抄作业的指南。

2. 核心方案选型与设计思路

在Edison上发邮件，听起来简单，但方案选型上稍有差池，就会在后期遇到各种麻烦。核心决策点围绕两个问题展开：用什么语言写？和怎么连接邮件服务器？

2.1 开发语言的选择：Python vs. Bash vs. C

Edison的Ubilinux系统预装了Python 2.7，这是最快速上手的路径。Python的smtplib和email库非常成熟，十几行代码就能搞定。它的优势是开发效率极高，原型验证快，且易于集成复杂的业务逻辑（比如先读取传感器数据，再组织邮件内容）。我主要推荐Python方案。

Bash脚本配合ssmtp或sendmail命令行工具是另一种极简选择。适合执行简单的、定时的通知任务，比如在Cron作业里运行。但它的缺点也很明显：错误处理能力弱，邮件内容格式化麻烦，安全性也差（密码可能以明文出现在脚本里）。

C语言（或C++）性能最优，资源占用最小，适合对执行时间和内存有严苛要求的场景。但开发成本最高，你需要手动处理SMTP协议套接字通信、Base64编码等底层细节，除非项目有强制要求，否则不推荐。

我的选择与理由：Python。在Edison的性能范围内，Python的便利性远大于其微小的性能开销。smtplib库隐藏了协议细节，让我们能专注于业务逻辑。此外，Python生态有大量用于硬件接口（如mraa、pySerial）、数据解析（如json）的库，方便未来功能扩展。对于绝大多数物联网通知场景，Python都是最佳平衡点。

2.2 邮件发送协议与服务器配置

确定了语言，下一步是决定如何与邮件服务器对话。这里有两个主流协议：SMTP和API。

SMTP（简单邮件传输协议）是电子邮件发送的基石协议。你需要一个支持SMTP的邮件服务器，比如Gmail、QQ邮箱、163邮箱或者你自己的企业邮局。这种方式最通用、最直接。

邮件服务商API（如SendGrid、Mailgun的API）是更现代的方式。它通常提供更友好的接口（HTTP RESTful API）、更详细的数据统计和更好的送达率管理。但需要注册服务，可能有免费额度限制，并且增加了对外部服务的依赖。

对于Edison这类边缘设备，我强烈建议使用SMTP协议配合一个可靠的第三方邮件服务（如Gmail或QQ邮箱）。原因如下：

1. 稳定性：大型邮件服务商的SMTP服务器可用性极高。
2. 安全性：它们普遍强制使用SSL/TLS加密（端口465或587），保障通信安全。
3. 免维护：你不需要自己搭建和维护邮件服务器，省心省力。
4. 兼容性：SMTP是标准协议，Python标准库原生支持，无需引入额外的第三方HTTP请求库。

注意事项：关于“应用专用密码”这是第一个大坑。如果你使用Gmail、QQ邮箱等，直接使用你的登录密码在第三方应用（如我们的Edison程序）中发邮件，很可能会触发安全机制被拒绝。必须开启SMTP服务并生成“应用专用密码”（App Password）或“授权码”。以QQ邮箱为例，你需要登录网页版邮箱，在“设置”->“账户”里开启POP3/SMTP服务，系统会给你一个16位的授权码，这个码才是程序中应该使用的密码。

2.3 程序架构设计

一个健壮的邮件通知程序不应该只是一个孤立的脚本。我建议采用模块化设计，将核心功能分解：

• 配置模块：独立存放SMTP服务器地址、端口、账号、授权码、收件人列表等敏感信息。绝对不要硬编码在主脚本里。可以使用一个单独的config.py文件或config.ini文件，方便管理和更换配置。
• 邮件构建模块：负责创建邮件对象，包括发件人、收件人、主题、正文（纯文本/HTML）、附件等。这部分逻辑应该和发送逻辑分离。
• 发送模块：核心发送函数，负责建立SMTP连接、登录、发送邮件并处理连接关闭。要做好异常捕获和重试机制。
• 主程序/触发逻辑：这是业务逻辑层。它可能是一个循环监测传感器状态的脚本，一个由Cron定时触发的任务，或者一个响应某个GPIO引脚事件的程序。它负责在适当的时候调用邮件发送模块。

这样的设计使得代码清晰、易于测试和维护。例如，当你需要更换邮件服务器时，只需修改配置文件；当需要调整邮件内容格式时，只需改动邮件构建模块。

3. 环境准备与依赖安装

在开始写代码之前，我们需要确保Edison的系统环境就绪。通过SSH连接到你的Edison开发板。

3.1 系统更新与Python环境确认

首先，更新软件包列表并升级现有包，这是一个好习惯。

opkg update opkg upgrade

检查Python版本。Edison的Ubilinux通常预装Python 2.7。虽然Python 2已停止维护，但对于这个简单任务完全够用，且无需额外安装。如果你想使用Python 3，需要手动安装，但可能会遇到一些库的兼容性问题。

python --version # 输出应为 Python 2.7.x

Python的smtplib和email库是标准库的一部分，通常已随Python安装，无需额外操作。

3.2 配置网络与测试连通性

确保Edison已经连接到互联网，并且可以解析域名。这是邮件发送的基础。

# 测试网络连通性，ping一个可靠的地址，比如谷歌的DNS ping -c 4 8.8.8.8 # 测试DNS解析 nslookup smtp.gmail.com

如果nslookup失败，可能需要检查/etc/resolv.conf文件中的DNS服务器配置。

3.3 准备邮箱并获取SMTP授权

如前所述，你需要一个支持SMTP的邮箱。这里以QQ邮箱为例（国内访问稳定），演示获取授权码的过程：

1. 登录QQ邮箱网页版。
2. 点击顶部“设置” -> “账户”。
3. 向下滚动到“POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务”部分。
4. 找到“POP3/SMTP服务”和“IMAP/SMTP服务”，点击“开启”。根据提示，可能需要用绑定的手机号发送一条短信进行验证。
5. 验证成功后，页面会显示一个16位的“授权码”。立即复制并妥善保存，这个码只会显示一次！它就是你的Edison程序登录SMTP服务器的密码。

记下QQ邮箱的SMTP服务器信息：

• SMTP服务器地址：smtp.qq.com
• SSL端口：465
• TLS端口：587（推荐，兼容性更好）

实操心得：使用TLS端口587端口465和587都支持加密。我倾向于使用端口587（STARTTLS）。它的工作方式是先建立明文连接，然后通过STARTTLS命令升级为加密连接。这种机制在某些网络环境下（如存在中间代理）兼容性更好。而端口465是“隐式TLS”，一上来就要求SSL加密，有时会被误判。

4. 核心代码实现与分步解析

环境就绪，我们来编写核心的Python脚本。我将代码分成配置、构建、发送三个部分，并逐行解释。

4.1 配置文件（config.ini）

创建一个名为config.ini的文件，用于存放所有敏感和可变的配置。

[SMTP] server = smtp.qq.com port = 587 username = [e-mail] # 你的QQ邮箱地址 password = your_16_digit_authorization_code # 你获取的16位授权码，不是QQ密码！ [MAIL] sender = [e-mail] # 发件人，通常和username一致 receivers = [e-mail], [e-mail] # 收件人列表，用逗号分隔 subject_prefix = [Edison Alert] # 邮件主题前缀，便于过滤

重要安全警告：config.ini文件包含了邮箱授权码，必须设置严格的文件权限，避免被其他用户读取。在Edison上执行：chmod 600 config.ini。更好的做法是在生产环境中，使用环境变量或硬件安全模块来存储密码，但对于原型和多数个人项目，配置文件加严格权限是可行的折中方案。

4.2 邮件发送模块（mail_sender.py）

这是核心功能模块，包含建立连接、登录、发送和错误处理。

#!/usr/bin/env python # -*- coding: utf-8 -*- import smtplib import logging from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart from email.header import Header import configparser import os import sys # 设置日志，便于调试和记录发送状态 logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s') logger = logging.getLogger(__name__) def send_email(subject, body, to_emails=None, is_html=False, attachments=None): """ 发送邮件的主函数 :param subject: 邮件主题字符串 :param body: 邮件正文字符串 :param to_emails: 收件人列表（字符串或列表）。如果为None，则使用配置文件中的默认收件人。 :param is_html: 正文是否为HTML格式，默认为False（纯文本） :param attachments: 附件路径列表，如 [‘/path/to/file1.pdf‘, ‘/path/to/image.png‘] :return: True发送成功，False发送失败 """ # 1. 加载配置 config = configparser.ConfigParser() config_path = os.path.join(os.path.dirname(__file__), 'config.ini') if not os.path.exists(config_path): logger.error("配置文件 config.ini 未找到！") return False config.read(config_path) smtp_server = config.get('SMTP', 'server') smtp_port = config.getint('SMTP', 'port') # 注意端口是整数 smtp_username = config.get('SMTP', 'username') smtp_password = config.get('SMTP', 'password') default_sender = config.get('MAIL', 'sender') default_receivers = [addr.strip() for addr in config.get('MAIL', 'receivers').split(',')] # 确定收件人 if to_emails is None: to_emails = default_receivers elif isinstance(to_emails, str): to_emails = [to_emails] # 2. 构建邮件对象 if attachments or is_html: # 如果需要附件或HTML，使用混合类型 msg = MIMEMultipart('alternative' if not attachments else 'mixed') msg.attach(MIMEText(body, 'html' if is_html else 'plain', 'utf-8')) else: # 纯文本邮件 msg = MIMEText(body, 'plain', 'utf-8') msg['From'] = Header(f'Edison Device <{default_sender}>', 'utf-8') msg['To'] = Header(','.join(to_emails), 'utf-8') msg['Subject'] = Header(subject, 'utf-8') # 3. 添加附件（如果存在） if attachments: for file_path in attachments: if not os.path.exists(file_path): logger.warning(f"附件 {file_path} 不存在，跳过。") continue import mimetypes from email import encoders from email.mime.base import MIMEBase ctype, encoding = mimetypes.guess_type(file_path) if ctype is None or encoding is not None: ctype = 'application/octet-stream' maintype, subtype = ctype.split('/', 1) with open(file_path, 'rb') as fp: part = MIMEBase(maintype, subtype) part.set_payload(fp.read()) encoders.encode_base64(part) # 对附件进行Base64编码 part.add_header('Content-Disposition', 'attachment', filename=os.path.basename(file_path)) msg.attach(part) # 4. 发送邮件 try: logger.info(f"正在连接SMTP服务器 {smtp_server}:{smtp_port}...") # 注意：这里使用SMTP_SSL还是SMTP取决于端口。端口465用SMTP_SSL，端口587用SMTP。 if smtp_port == 465: server = smtplib.SMTP_SSL(smtp_server, smtp_port, timeout=30) else: server = smtplib.SMTP(smtp_server, smtp_port, timeout=30) server.starttls() # 对于端口587，必须调用starttls()启用加密 server.login(smtp_username, smtp_password) server.sendmail(default_sender, to_emails, msg.as_string()) server.quit() logger.info(f"邮件发送成功！主题：{subject}") return True except smtplib.SMTPAuthenticationError: logger.error("SMTP认证失败！请检查用户名和授权码（密码）是否正确。") except smtplib.SMTPException as e: logger.error(f"SMTP协议错误：{e}") except Exception as e: logger.error(f"发送邮件时发生未知错误：{e}") return False if __name__ == '__main__': # 模块测试代码 test_subject = "Edison邮件通知测试" test_body = """ 这是一封来自Intel Edison开发板的测试邮件。 发送时间：{} 当前系统状态：正常。 """.format(datetime.now().strftime('%Y-%m-%d %H:%M:%S')) if send_email(test_subject, test_body): print("测试邮件发送成功！") else: print("测试邮件发送失败，请查看日志。")

关键代码解析：

1. MIMEMultipartvsMIMEText：如果邮件只是纯文本，MIMEText就够了。但如果需要同时支持纯文本和HTML版本，或者要添加附件，就必须使用MIMEMultipart容器。‘alternative‘用于同一内容的不同格式（如纯文本+HTML），‘mixed‘用于包含附件的邮件。
2. Header与编码：使用Header对象并指定‘utf-8‘编码，可以确保邮件主题和收件人名称包含中文等非ASCII字符时不会乱码。
3. 端口与加密处理：这是第二个大坑。代码中通过判断端口号（465或587）来选择合适的连接方式。对于587端口，必须先建立普通SMTP连接，然后调用server.starttls()来启动加密。忘记这一步会导致连接被服务器拒绝或通信明文传输。
4. 异常捕获：我们捕获了特定的SMTPAuthenticationError（认证错误）和通用的SMTPException，并记录到日志。这对于无人值守的设备调试至关重要。timeout=30设置了连接超时，避免网络不佳时程序长时间挂起。
5. 附件处理：附件读取需要使用二进制模式（‘rb‘），并通过encode_base64进行编码，这是SMTP协议传输非文本内容的标准方式。mimetypes.guess_type用于自动判断文件类型。

4.3 主程序示例：结合传感器触发

现在，我们将邮件发送功能集成到一个具体的场景中：当Edison读取到的温度传感器值超过阈值时，发送报警邮件。

假设你已使用mraa库连接了一个模拟温度传感器到Edison的A0引脚。

#!/usr/bin/env python # -*- coding: utf-8 -*- import time import mraa import sys import os sys.path.append(os.path.dirname(os.path.abspath(__file__))) from mail_sender import send_email # 初始化模拟引脚A0 temp_pin = mraa.Aio(0) # 假设传感器特性：ADC值（0-1023）对应电压（0-5V），温度传感器每10mV/°C，0V对应0°C。 ADC_REF = 1023.0 VOLTAGE_REF = 5.0 MV_PER_C = 10.0 # 每摄氏度10毫伏 def read_temperature_c(): """读取温度传感器，返回摄氏度值""" adc_value = temp_pin.read() voltage = (adc_value / ADC_REF) * VOLTAGE_REF # 计算电压值 temperature_c = voltage * 1000 / MV_PER_C # 电压(mV) / (10mV/°C) = 温度(°C) return temperature_c def main(): ALERT_THRESHOLD = 30.0 # 报警阈值，30摄氏度 CHECK_INTERVAL = 10 # 检查间隔，10秒 last_alert_time = 0 ALERT_COOLDOWN = 300 # 报警冷却时间，5分钟内不重复报警（300秒） logger.info("开始温度监控...") try: while True: temp = read_temperature_c() logger.info(f"当前温度：{temp:.2f} °C") current_time = time.time() if temp > ALERT_THRESHOLD and (current_time - last_alert_time) > ALERT_COOLDOWN: # 触发报警邮件 subject = f"高温警报！当前温度：{temp:.1f}°C" body = f""" 设备：Intel Edison (位置：车间A区) 时间：{time.strftime('%Y-%m-%d %H:%M:%S')} 读数：温度传感器 当前值：{temp:.2f} °C 报警阈值：{ALERT_THRESHOLD} °C 状态：**超过阈值，请及时处理！** """ if send_email(subject, body): last_alert_time = current_time logger.warning(f"已发送高温报警邮件。") else: logger.error("发送报警邮件失败！") time.sleep(CHECK_INTERVAL) except KeyboardInterrupt: logger.info("监控程序被用户中断。") except Exception as e: logger.error(f"监控程序运行出错：{e}") # 程序自身出错，尝试发送一封错误报告邮件 error_subject = "Edison温度监控程序异常退出" error_body = f"程序于 {time.strftime('%Y-%m-%d %H:%M:%S')} 发生异常：\n{str(e)}" send_email(error_subject, error_body) if __name__ == '__main__': main()

设计亮点与避坑指南：

1. 报警冷却机制（Cooldown）：这是第三个关键技巧。如果没有冷却时间，当温度持续高于阈值时，程序会在每个循环周期（10秒）都发送一封邮件，导致邮箱被轰炸。ALERT_COOLDOWN变量确保了在设定的时间间隔内，只发送一次报警邮件。
2. 程序自监控：在main函数的顶层try-except中，我们捕获了所有未处理的异常。一旦程序本身崩溃，它会尝试在退出前发送最后一封邮件报告错误。这对于远程无人值守的设备是救命稻草，让你能知道设备“死”了，而不是简单地停止报告。
3. 路径处理：sys.path.append(...)这行确保了主程序能找到同目录下的mail_sender模块。这是一种简单的模块导入方式。
4. 传感器数据处理：示例中包含了从ADC原始值到实际温度值的换算。在实际项目中，你需要根据传感器的数据手册来编写这个换算函数，可能涉及更复杂的公式或查表法。

5. 部署、调试与稳定性优化

代码写好了，但在Edison上稳定运行又是另一回事。

5.1 部署与权限设置

1. 文件传输：使用scp命令将你的Python脚本和config.ini文件从开发电脑上传到Edison。

   scp mail_sender.py config.ini root@<你的Edison_IP地址>:/home/root/alert_system/

2. 目录结构：在Edison上创建一个项目目录，例如/home/root/alert_system，将所有文件放进去，保持结构清晰。
3. 设置文件权限：

   chmod 700 /home/root/alert_system # 目录权限 chmod 600 /home/root/alert_system/config.ini # 配置文件仅所有者可读 chmod +x /home/root/alert_system/temperature_monitor.py # 主程序可执行

4. 测试运行：首先手动运行一次，确保一切正常。

   cd /home/root/alert_system python temperature_monitor.py

   观察控制台输出和你的收件箱。

5.2 配置系统服务实现开机自启与守护

手动运行不是长久之计。我们需要让程序作为系统服务在后台运行，并在开机时自动启动。这里使用systemd，这是现代Linux发行版的标准服务管理工具。

在Edison上创建服务文件：/etc/systemd/system/edison-mail-alert.service

[Unit] Description=Edison Temperature Monitor and Mail Alert Service After=network.target # 确保在网络就绪后启动 Wants=network.target [Service] Type=simple User=root WorkingDirectory=/home/root/alert_system ExecStart=/usr/bin/python /home/root/alert_system/temperature_monitor.py Restart=on-failure # 程序异常退出时自动重启 RestartSec=10s # 重启前等待10秒 StandardOutput=syslog # 将标准输出重定向到系统日志 StandardError=syslog # 将标准错误重定向到系统日志 [Install] WantedBy=multi-user.target

关键配置解释：

• After=network.target：确保服务在网络服务启动之后才运行，避免因网络未就绪导致SMTP连接失败。
• Restart=on-failure和RestartSec=10s：这是保障稳定性的核心。当程序因网络波动、邮件服务器暂时不可用等异常退出时，systemd会在10秒后自动重启它。这极大地增强了服务的健壮性。
• StandardOutput=syslog：将程序的打印输出重定向到系统日志（如journalctl），方便我们查看运行状态，而无需连接SSH。

启用并启动服务：

systemctl daemon-reload # 重新加载systemd配置 systemctl enable edison-mail-alert.service # 启用开机自启 systemctl start edison-mail-alert.service # 立即启动服务 systemctl status edison-mail-alert.service # 查看服务状态

查看服务日志：

journalctl -u edison-mail-alert.service -f # 实时跟踪日志 journalctl -u edison-mail-alert.service --since "1 hour ago" # 查看最近一小时的日志

5.3 网络波动与发送失败处理

边缘设备的网络环境可能不稳定。我们的代码已经有了基本的异常捕获，但可以更进一步优化mail_sender.py中的发送函数，加入重试机制。

修改send_email函数中的发送部分：

def send_email(...): # ... [前面的配置和构建邮件代码不变] ... # 4. 发送邮件（带重试） max_retries = 3 retry_delay = 5 # 秒 for attempt in range(max_retries): try: logger.info(f"尝试第 {attempt+1} 次连接SMTP服务器...") if smtp_port == 465: server = smtplib.SMTP_SSL(smtp_server, smtp_port, timeout=30) else: server = smtplib.SMTP(smtp_server, smtp_port, timeout=30) server.starttls() server.login(smtp_username, smtp_password) server.sendmail(default_sender, to_emails, msg.as_string()) server.quit() logger.info(f"邮件发送成功！主题：{subject}") return True except (smtplib.SMTPException, TimeoutError, ConnectionError) as e: logger.warning(f"第 {attempt+1} 次发送失败：{e}") if attempt < max_retries - 1: logger.info(f"{retry_delay}秒后重试...") time.sleep(retry_delay) else: logger.error(f"邮件发送失败，已重试{max_retries}次。") return False except Exception as e: logger.error(f"发送邮件时发生未知错误：{e}") return False # 非网络/SMTP错误，直接返回失败

这个改进版在遇到网络超时、连接错误或SMTP临时错误时，会等待片刻后重试，最多3次。这能有效应对短暂的网络抖动。

6. 常见问题排查与实战技巧

即使按照步骤操作，你也可能会遇到问题。下面是我在实践中总结的常见问题清单和解决方法。

6.1 连接与认证失败

问题现象	可能原因	排查步骤与解决方案
SMTPAuthenticationError(535错误)	1. 用户名/密码错误。 2. 未使用“授权码”而使用了邮箱登录密码。 3. 邮箱未开启SMTP服务。	1.核对config.ini：确保username是完整邮箱地址，password是16位授权码（无空格）。 2.重新获取授权码：登录邮箱设置页面，关闭后重新开启SMTP服务，生成新授权码并更新配置。 3.测试命令：在电脑上用Python脚本（使用相同配置）测试，排除Edison环境问题。
ConnectionRefusedError或TimeoutError	1. SMTP服务器地址或端口错误。 2. Edison网络不通。 3. 防火墙/路由器屏蔽了SMTP端口。	1.验证地址端口：确认smtp.qq.com和587无误。尝试telnet smtp.qq.com 587（Edison上需安装telnet）看能否建立TCP连接。 2.检查Edison网络：ping 8.8.8.8，nslookup smtp.qq.com。 3.尝试端口465：将配置中的端口改为465，同时将代码中连接方式改为SMTP_SSL。
SMTPNotSupportedError: STARTTLS extension not supported	服务器不支持STARTTLS，或连接被中间代理干扰。	1.换用端口465和SSL：这是最直接的解决方案。 2. 检查是否在代码中错误地对端口465调用了starttls()。

6.2 邮件发送成功但收不到

问题现象	可能原因	排查步骤与解决方案
收件箱和垃圾箱都没有	1. 被邮件服务商当作垃圾邮件拦截。 2. 发件人地址不被信任。	1.检查发件人地址：确保config.ini中的sender和username是同一个且有效的邮箱。 2.简化邮件内容：首次测试时，使用纯文本、无链接、无附件的简单主题和正文。 3.添加友好标识：在主题或正文开头加入[YourDeviceName]等标识。 4.检查收件人地址：确保没有拼写错误。
进入垃圾邮件箱	邮件内容或发送模式触发反垃圾邮件规则。	1.将发件人地址加入联系人。 2.避免使用敏感词：如“警报”、“免费”、“测试”等，可改用“通知”、“提示”、“系统消息”。 3.添加退订说明（如果适用）。

6.3 程序运行不稳定

问题现象	可能原因	排查步骤与解决方案
程序运行一段时间后内存占用高或崩溃	内存泄漏。可能是在循环中不断创建对象未释放。	1.检查循环代码：确保在while True循环中，没有不必要的全局变量累积。传感器读数等临时变量没问题。 2.简化邮件对象创建：如果邮件内容固定，可以考虑在循环外创建MIME对象模板，循环内只更新变化的部分（如时间、数据）。 3.使用systemd的Restart：这是最后的保障，让服务自动重启。
定时任务（Cron）不执行	1. Cron环境变量与交互Shell不同。 2. 脚本路径问题。 3. 脚本没有执行权限。	1.在Cron命令中指定绝对路径：/usr/bin/python /home/root/alert_system/send_report.py。 2.在脚本开头设置环境变量：如PYTHONPATH。 3.将输出重定向到日志文件：在Cron行末尾添加>> /home/root/cron.log 2>&1，便于调试。

6.4 高级技巧与扩展思路

1. 邮件内容模板化：对于内容复杂的邮件（如日报），可以使用Jinja2等模板引擎，将HTML模板和数据进行分离，使代码更清晰。
2. 支持多个邮件服务器备用：在config.ini中配置多个SMTP服务器信息，在send_email函数中实现简单的故障转移逻辑，当主服务器发送失败时，自动尝试备用服务器。
3. 本地邮件队列：对于极高可靠性要求的场景，可以在发送失败时将邮件内容（序列化后的对象或文本）暂存到Edison的本地文件或轻量级数据库（如SQLite）中，然后由一个独立的守护进程定期重试发送队列中的邮件。这可以防止因网络中断导致的关键警报丢失。
4. 与消息队列结合：在更复杂的物联网架构中，Edison可以不直接发邮件，而是将报警事件发布到本地的MQTT代理（如Mosquitto），再由树莓派或中央服务器订阅该主题并发送邮件。这样解耦了边缘计算和通知服务，使系统更灵活。

最后，我个人最深刻的体会是：在边缘设备上做通知，可靠性设计比功能实现更重要。网络是不稳定的，资源是有限的。你的代码必须假设一切外部依赖都可能失败，并通过重试、队列、守护进程和详尽的日志，为自己构建一个“安全网”。那个在Edison上稳定运行了两年多的温度监控系统，最初版本也经常失联，正是通过一次次添加上述的“稳定性补丁”，才最终成为了值得信赖的“沉默哨兵”。从能跑到跑得稳，这中间的差距，就是这些看似琐碎的细节堆砌起来的。