RPA与Python测试自动化集成：pytest+email.mime实现智能报告分发

1. 项目概述：当RPA遇上Python测试自动化

最近在做一个企业流程自动化的项目，客户那边有个挺头疼的需求：他们每天有几十个业务流程需要跑，每个流程跑完都会生成一份测试报告，然后需要把这些报告自动发送给不同的负责人。一开始他们用传统的RPA工具（比如影刀、Codex）来模拟点击和发送邮件，但遇到复杂的数据校验和测试逻辑断言时就有点力不从心了，经常因为页面元素变化或者邮件格式不对导致流程中断。这让我开始思考，能不能把Python强大的测试框架和邮件处理能力，直接集成到RPA的流程里，做一个更“聪明”的自动化方案？

这就是“RPA-Python与pytest-email.mime集成”这个项目想解决的问题。它的核心思路，不是让RPA机器人去笨拙地操作邮件客户端，而是让RPA流程调用一个用Python写的、基于pytest的测试套件。这个测试套件负责执行所有复杂的业务逻辑验证和数据处理，生成结构化的测试结果，然后利用Python标准库里的email.mime模块，精准地构建一封包含HTML报告、附件和定制化内容的邮件，最后通过SMTP协议直接发送出去。这样一来，RPA流程只负责调度和触发这个“测试与报告发送”的黑盒模块，把专业的事交给专业的工具，稳定性和灵活性都大大提升。

这个方案特别适合那些已经有一定RPA基础，但苦于测试验证环节薄弱、报告分发流程僵化的团队。如果你正在用影刀RPA做数据采集，用Codex处理表单，但后续的数据准确性检查和结果通知还得人工介入，那么这个集成方案能帮你把最后一段“断头路”也自动化起来。它本质上是在RPA的“四肢”（UI操作）之外，为其装上一个“大脑”（逻辑测试）和“嘴巴”（精准通信）。

2. 核心架构与工具选型解析

2.1 为什么是Python + pytest + email.mime？

在决定技术栈时，我主要权衡了开发效率、生态成熟度和与RPA的集成便利性。Python几乎是自动化领域的不二之选，语法简洁，库资源丰富，无论是影刀RPA还是Codex RPA，都提供了对Python脚本的良好支持，可以通过调用命令行或特定的SDK来执行.py文件。

选择pytest而不是unittest或其他测试框架，原因有几个。首先，pytest的断言更直观，写出来的测试用例像自然语言，可读性高。其次，它的夹具（fixture）机制非常强大，可以优雅地管理测试数据、初始化测试环境（比如连接数据库、启动临时服务），这对于模拟RPA流程的上下文环境至关重要。最后，pytest有丰富的插件生态，比如pytest-html可以一键生成美观的HTML报告，这正是我们需要的。

而邮件处理，为什么不用更上层的库如yagmail或smtplib直接拼接字符串呢？因为email.mime模块提供了最底层、最灵活的控制能力。RPA生成的报告可能多样：一份主流的HTML格式报告、一个包含原始数据的CSV附件、甚至几张截图。email.mime允许我们构建一个多部分的邮件体（Multipart），将文本内容、HTML内容、各种格式的附件像搭积木一样组合起来，确保在任何邮件客户端都能正确显示。这对于需要发送给管理层、格式要求严格的场景，是必不可少的。

2.2 整体工作流设计

整个集成的架构可以看作一个清晰的管道（Pipeline）：

1. 触发阶段：RPA流程执行到需要验证和发送报告的节点。例如，影刀RPA完成了一个财务报表的数据抓取和录入。
2. 调用与执行阶段：RPA工具通过执行系统命令（如python -m pytest script.py --html=report.html）调用我们写好的Python测试脚本。这个脚本内包含用pytest编写的测试用例，用于验证RPA抓取的数据准确性（如总额计算是否正确、关键字段是否缺失）。
3. 报告生成阶段：pytest执行完毕，通过pytest-html插件生成一个report.html文件。同时，我们的脚本可以自定义收集更多日志或数据，生成CSV等附件。
4. 邮件构建与发送阶段：另一个Python脚本（或集成在测试脚本的收尾部分）启动。它使用email.mime模块：
   • 用MIMEMultipart创建邮件容器。
   • 用MIMEText添加纯文本和HTML正文（可以直接将report.html的内容嵌入，或生成摘要）。
   • 用MIMEApplication或MIMEText添加HTML报告文件和CSV文件作为附件。
   • 设置发件人、收件人、主题等头部信息。
   • 使用smtplib连接SMTP服务器（如公司邮箱服务器、QQ邮箱SMTP等）发送邮件。
5. 反馈与决策阶段：RPA流程可以捕获Python脚本的退出码（pytest返回0表示全部测试通过，非0表示有失败）。根据这个退出码，RPA流程可以决定是继续执行下一个任务，还是触发告警，进入异常处理分支。

这个设计将测试逻辑和邮件通信逻辑从RPA的图形化流程中解耦出来，使得两者都可以独立维护和升级。测试工程师可以专注地用Python写更复杂的校验规则，而不必深究RPA工具的内部语法。

3. 环境搭建与核心组件实战

3.1 Python与pytest环境配置

首先，你需要一个干净的Python环境。建议使用conda或venv创建虚拟环境，避免包冲突。

# 创建并激活虚拟环境 python -m venv rpa_test_env source rpa_test_env/bin/activate # Linux/Mac # 或 rpa_test_env\Scripts\activate # Windows # 安装核心包 pip install pytest pytest-html

pytest-html是生成报告的关键插件。这里有个注意事项：网络上的教程可能会让你安装pytest-html的老版本，但新版本（3.x以上）的API和输出格式可能有变化。为了稳定，我通常指定一个稍旧但广泛验证的版本，比如：

pip install pytest-html==3.2.0

对于IDE，VSCode是绝佳选择。安装Python扩展后，配置好刚才创建的虚拟环境路径，就可以获得代码提示、调试和直接在IDE内运行pytest的便利。在settings.json中配置：

{ "python.defaultInterpreterPath": "/path/to/your/rpa_test_env/bin/python" }

3.2 构建你的第一个pytest测试模块

测试模块的组织结构很重要。我推荐的项目结构如下：

rpa_email_project/ ├── conftest.py # pytest全局配置文件，放置共享fixture ├── test_data/ # 存放测试数据文件 ├── reports/ # 存放生成的html报告（.gitignore忽略） ├── utils/ # 工具函数，如数据读取、清理 ├── test_financial_report.py # 具体的测试用例文件 └── send_email.py # 邮件发送脚本

在conftest.py中，我们可以定义一些RPA流程共享的fixture。例如，模拟RPA传递过来的数据：

# conftest.py import pytest import pandas as pd @pytest.fixture(scope="session") def rpa_extracted_data(): """模拟RPA流程提取的数据，可以从文件或变量读取""" # 假设RPA将数据保存为CSV data_path = "test_data/extracted_transactions.csv" try: df = pd.read_csv(data_path) except FileNotFoundError: # 如果文件不存在，创建一个模拟数据，用于演示 df = pd.DataFrame({ 'date': ['2023-10-26', '2023-10-27'], 'amount': [1500.00, -200.50], 'category': ['收入', '支出'] }) return df

然后，在test_financial_report.py中编写具体的测试用例：

# test_financial_report.py import pandas as pd class TestFinancialReport: """财务报告数据校验测试集""" def test_dataframe_not_empty(self, rpa_extracted_data): """校验RPA提取的数据不为空""" assert not rpa_extracted_data.empty, "RPA提取的数据为空，请检查流程。" def test_total_balance(self, rpa_extracted_data): """校验总收入减去总支出后的余额计算正确""" # 假设amount列正数为收入，负数为支出 total_income = rpa_extracted_data[rpa_extracted_data['amount'] > 0]['amount'].sum() total_expense = abs(rpa_extracted_data[rpa_extracted_data['amount'] < 0]['amount'].sum()) expected_balance = total_income - total_expense # 这里可以引入一个从其他系统获取的预期值，进行对比 # expected_from_system = 1299.50 # assert expected_balance == expected_from_system # 演示起见，我们只断言余额大于0（一个业务逻辑） assert expected_balance >= 0, f"计算出的余额为负：{expected_balance}" def test_no_missing_critical_fields(self, rpa_extracted_data): """校验关键字段（如日期、金额）无缺失""" critical_columns = ['date', 'amount'] for col in critical_columns: # 使用pytest的内置断言信息增强 missing_count = rpa_extracted_data[col].isnull().sum() assert missing_count == 0, f"关键字段 '{col}' 有 {missing_count} 条数据缺失"

注意：测试用例的命名要以test_开头，这是pytest的发现规则。使用有意义的断言信息，这样当测试失败时，报告会非常清晰。

3.3 生成HTML测试报告

有了测试用例，我们需要在运行时生成报告。这可以通过pytest的命令行参数实现。通常，我会写一个简单的启动脚本run_tests.py，或者直接在RPA中拼接命令。

# run_tests.py 一种更可控的方式 import subprocess import sys def main(): # 定义命令行参数 args = [ sys.executable, '-m', 'pytest', 'test_financial_report.py', # 指定测试文件 '-v', # 详细输出 '--html=reports/report.html', # 生成HTML报告 '--self-contained-html', # 将CSS等内联，使报告单文件化 '--capture=sys', # 捕获系统输出 # '--tb=short' # 如果堆栈信息太长，可以用short格式 ] print("开始执行测试...") result = subprocess.run(args, capture_output=True, text=True) print("标准输出：", result.stdout) if result.stderr: print("标准错误：", result.stderr) # 返回退出码，供RPA判断 sys.exit(result.returncode) if __name__ == "__main__": main()

执行这个脚本后，会在reports目录下生成一个report.html文件。用浏览器打开，可以看到每个测试用例的执行状态、耗时以及失败时的详细断言错误信息。这个文件就是我们即将通过邮件发送的核心内容。

4. 使用email.mime构建专业邮件

4.1 解剖一封多部分邮件

直接使用smtplib发送简单文本邮件很容易，但要发送带格式正文、内嵌图片和附件的邮件，就需要理解MIME（多用途互联网邮件扩展）协议。email.mime模块下的类帮助我们构建符合MIME标准的邮件体。

一封典型的报告邮件包含：

1. 邮件头（Headers）：From, To, Subject, Date等。
2. 邮件体（Body），是一个MIMEMultipart容器，里面又包含：
   • 第一部分：MIMEText，用于纯文本正文（给不支持HTML的邮件客户端）。
   • 第二部分：MIMEText，用于HTML正文（展示丰富的报告摘要）。
   • 第三部分：MIMEApplication， 附件1（完整的HTML报告文件）。
   • 第四部分：MIMEApplication， 附件2（原始数据CSV文件）。

4.2 邮件发送脚本详解

下面是一个功能完整的send_email.py脚本：

# send_email.py import smtplib from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.application import MIMEApplication from email.utils import formatdate, make_msgid import os import sys def send_test_report(smtp_server, smtp_port, sender, password, receivers, subject, html_report_path, csv_attachment_path=None): """ 发送测试报告邮件 Args: smtp_server: SMTP服务器地址，如 'smtp.qq.com' smtp_port: 端口，QQ邮箱SSL为465，STARTTLS为587 sender: 发件邮箱 password: 授权码（注意不是邮箱密码） receivers: 收件人列表，如 ['zhangsan@company.com', 'lisi@company.com'] subject: 邮件主题 html_report_path: 生成的pytest-html报告路径 csv_attachment_path: 可选的CSV数据附件路径 """ # 1. 创建邮件根容器 msg = MIMEMultipart('mixed') msg['From'] = sender msg['To'] = ', '.join(receivers) # 多个收件人用逗号分隔 msg['Subject'] = subject msg['Date'] = formatdate(localtime=True) msg['Message-ID'] = make_msgid() # 生成唯一消息ID # 2. 创建正文部分的容器（alternative用于文本/HTML二选一显示） body_part = MIMEMultipart('alternative') msg.attach(body_part) # 3. 创建纯文本正文 text_content = """ 您好， 自动化测试报告已生成，详情请查看附件中的HTML报告。 此邮件由RPA自动化流程发送。 """ text_body = MIMEText(text_content, 'plain', 'utf-8') body_part.attach(text_body) # 4. 创建HTML正文（可以从报告中提取摘要，这里简单写死） html_content = """ <html> <body> <h2>自动化测试报告通知</h2> <p>本次RPA流程触发的数据校验测试已完成。</p> <p><strong>报告摘要：</strong></p> <ul> <li>测试用例总数：3</li> <li>通过数：2</li> <li>失败数：1</li> <li>详细结果请下载并查看附件 <code>report.html</code>。</li> </ul> <p><em>此邮件为自动发送，请勿直接回复。</em></p> </body> </html> """ html_body = MIMEText(html_content, 'html', 'utf-8') body_part.attach(html_body) # 5. 附加HTML报告文件 if os.path.exists(html_report_path): with open(html_report_path, 'rb') as f: report_attachment = MIMEApplication(f.read(), _subtype='html') report_attachment.add_header('Content-Disposition', 'attachment', filename=os.path.basename(html_report_path)) msg.attach(report_attachment) else: print(f"警告：报告文件 {html_report_path} 不存在，将不附加。") # 可以在HTML正文中更新这个信息 # 或者考虑发送错误通知 # 6. 附加CSV数据文件（可选） if csv_attachment_path and os.path.exists(csv_attachment_path): with open(csv_attachment_path, 'rb') as f: csv_attachment = MIMEApplication(f.read(), _subtype='csv') csv_attachment.add_header('Content-Disposition', 'attachment', filename=os.path.basename(csv_attachment_path)) msg.attach(csv_attachment) # 7. 连接服务器并发送 try: # 使用SSL加密连接（端口465） with smtplib.SMTP_SSL(smtp_server, smtp_port) as server: server.login(sender, password) server.sendmail(sender, receivers, msg.as_string()) print("邮件发送成功！") except Exception as e: print(f"邮件发送失败：{e}") sys.exit(1) # 发送失败，返回非0退出码 if __name__ == "__main__": # 配置参数（实际应用中应从环境变量或配置文件中读取，切勿硬编码密码！） SMTP_SERVER = 'smtp.qq.com' SMTP_PORT = 465 SENDER_EMAIL = 'your_email@qq.com' # 注意：这里填QQ邮箱的授权码，不是登录密码！ SENDER_AUTH_CODE = 'your_authorization_code' RECEIVERS = ['receiver1@example.com', 'receiver2@example.com'] EMAIL_SUBJECT = '【RPA自动化】每日财务数据校验报告 - 2023-10-27' HTML_REPORT = 'reports/report.html' CSV_DATA = 'test_data/extracted_transactions.csv' # 可选 send_test_report(SMTP_SERVER, SMTP_PORT, SENDER_EMAIL, SENDER_AUTH_CODE, RECEIVERS, EMAIL_SUBJECT, HTML_REPORT, CSV_DATA)

重要安全提示：绝对不要将邮箱密码或授权码直接写在源代码中提交到版本控制系统（如Git）。务必使用环境变量、配置文件（.ini,.yaml）或密钥管理服务来存储这些敏感信息。例如，使用python-dotenv加载.env文件。

5. RPA流程集成与调度策略

5.1 在影刀RPA中调用Python脚本

以影刀RPA为例，集成上述Python模块非常简单。你只需要在流程图中插入一个“执行命令”或“运行Python脚本”的组件。

1. 准备环境：确保运行影刀RPA的机器上已经安装了Python，并且安装了项目所需的所有依赖包（pytest,pytest-html,pandas等）。最好使用虚拟环境的绝对路径。
2. 设计流程节点：
   • 节点1：执行数据抓取与处理的RPA流程，并将需要校验的中间数据保存为一个CSV文件（如test_data/extracted_transactions.csv）。
   • 节点2：“执行命令”组件。命令填写为：

     C:\Users\YourName\venvs\rpa_test_env\Scripts\python.exe C:\path\to\your\project\run_tests.py

     或者，如果你将run_tests.py和send_email.py的逻辑合并到一个主脚本，可以直接调用这个主脚本。
   • 节点3：“条件判断”组件。判断上一步命令执行的退出码（影刀通常能捕获这个值）。
     • 如果退出码为0（测试全部通过），流程继续，可以执行后续的成功分支，比如将报告路径记录到日志。
     • 如果退出码非0（测试失败），流程跳转到异常处理分支，可以发送紧急告警（比如通过企业微信机器人）、截图当前错误界面，并停止后续流程。

5.2 在Codex RPA或其他工具中的集成

Codex RPA、UiPath等工具原理类似。它们通常支持：

• 调用本地程序/脚本：直接执行Python解释器运行你的.py文件。
• 使用Python活动：一些RPA工具内置了Python脚本执行组件，你甚至可以直接在RPA编辑器中编写关键的Python校验代码片段，但为了可维护性，我仍然推荐调用外部独立的脚本文件。
• 获取输出：RPA工具可以捕获Python脚本在控制台打印的标准输出和标准错误，这些信息可以写入RPA自身的日志系统，便于追踪。

关键在于标准化接口：定义好RPA流程传递给Python脚本的数据文件路径和格式，以及Python脚本返回给RPA的退出码含义。例如，约定退出码0为成功，1为测试失败，2为系统错误（如模块导入失败）。

6. 高级技巧与避坑指南

6.1 动态生成邮件内容与报告解析

上面的例子中，邮件HTML正文是写死的。更高级的做法是，解析pytest-html生成的报告，动态提取通过率、失败用例名称等信息，填充到邮件正文中。

你可以写一个函数来解析HTML报告：

from bs4 import BeautifulSoup def parse_pytest_html_report(report_path): """解析pytest-html报告，提取关键信息""" with open(report_path, 'r', encoding='utf-8') as f: soup = BeautifulSoup(f.read(), 'html.parser') # 查找通过和失败的数量（pytest-html的报告结构可能随版本变化） # 这里是一个示例，实际需要根据你使用的pytest-html版本调整选择器 summary = soup.find('div', id='summary') if summary: # 更稳健的方法是查找具体的表格或标签 pass_count = len(soup.select('.passed')) # 示例，可能不准确 fail_count = len(soup.select('.failed')) # 或者从“Results”表格中解析 # ... return pass_count, fail_count return 0, 0

然后在构建HTML邮件正文时，使用这些动态数据：

pass_count, fail_count = parse_pytest_html_report(html_report_path) html_content = f""" <html><body> <h2>测试执行完成</h2> <p>通过数：<span style=\"color:green\">{pass_count}</span></p> <p>失败数：<span style=\"color:red\">{fail_count}</span></p> </body></html> """

6.2 邮件发送的稳定性与重试机制

网络波动或SMTP服务器临时故障可能导致发送失败。在生产环境中，必须加入重试机制和更完善的错误处理。

import time def send_email_with_retry(..., max_retries=3): retry_count = 0 while retry_count < max_retries: try: send_test_report(...) # 调用之前的发送函数 return True # 发送成功，退出循环 except (smtplib.SMTPException, ConnectionError) as e: retry_count += 1 print(f"第{retry_count}次发送失败: {e}") if retry_count == max_retries: print("达到最大重试次数，发送失败。") # 此处可以触发更高级的告警，如打电话、发短信 return False wait_time = 2 ** retry_count # 指数退避 print(f"等待{wait_time}秒后重试...") time.sleep(wait_time)

6.3 常见问题排查（FAQ）

1. Q: pytest执行成功，但生成的report.html是空的或格式错乱。

   • A: 检查pytest-html版本。确保使用了--self-contained-html参数生成独立的HTML。也可能是测试脚本路径不对，pytest没有找到任何test_开头的用例。

2. Q: 邮件能发送，但收件人看不到附件，或者附件是乱码。

   • A: 首先检查add_header时指定的filename是否正确。其次，对于非文本附件（如图片、压缩包），使用MIMEApplication并正确设置_subtype（如'octet-stream'）。对于文本附件，使用MIMEText并指定编码。确保在读取文件时使用二进制模式（'rb'）。

3. Q: 使用公司邮箱服务器（如Exchange）发送失败，提示认证错误。

   • A: 公司邮箱可能要求使用STARTTLS加密而非SSL，或者使用了不同的端口（如587）。需要将smtplib.SMTP_SSL改为smtplib.SMTP，并在登录前调用starttls()方法。具体参数需咨询公司IT部门。

4. Q: RPA流程调用Python脚本后，界面卡住或无响应。

   • A: 可能是Python脚本中有阻塞操作或等待用户输入。确保脚本是全自动的，所有操作都有超时设置。在RPA中调用时，可以尝试使用“后台运行”或“隐藏窗口”的选项。另外，检查Python脚本的路径和依赖环境是否在RPA运行用户的上下文中可用。

5. Q: 如何管理不同的收件人列表和邮件模板？

   • A: 建议使用配置文件（如config.yaml）来管理环境相关的变量。

     # config.yaml email: smtp_server: smtp.qq.com smtp_port: 465 sender: automation@company.com receivers: daily: [team_lead@company.com, manager@company.com] on_failure: [dev_ops@company.com] templates: daily_subject: "每日RPA测试报告 - {date}"

     在Python脚本中读取这个配置，根据测试结果（通过/失败）选择不同的收件人组和主题模板。

将这个方案落地后，最深的体会是“边界清晰”带来的维护便利。RPA流程负责它擅长的、规则明确的界面操作和流程串联；Python脚本负责复杂的逻辑判断、数据验证和通信任务。两者通过文件（CSV）和退出码这种简单粗暴却极其稳定的方式交互，任何一方的修改都不会轻易波及另一方。当测试逻辑需要增加一个复杂的统计指标时，我只需要修改test_financial_report.py里的一个函数，而完全不用去动那个已经稳定运行了上百个任务的影刀流程。这种解耦，对于长期维护一个自动化系统来说，价值巨大。