robotframework 在执行过程中常因日志缓冲机制导致进程挂起，尤其在大量日志输出时（如第30行左右）出现无响应。本文提供一种绕过 robotframework 日志管道、直接由 python 写入文件的高效规避方案。
robotframework 在执行过程中常因日志缓冲机制导致进程挂起，尤其在大量日志输出时（如第30行左右）出现无响应。本文提供一种绕过 robotframework 日志管道、直接由 python 写入文件的高效规避方案。
当 RobotFramework 运行包含高频 print() 或 BuiltIn().log() 调用的测试用例（尤其是调用自定义 Python 库时），常在日志输出约 30 行后发生无响应（hang）。根本原因在于：RobotFramework 通过标准输出（stdout）捕获并重定向日志，而底层 Python 的 sys.stdout 在某些环境（如 Windows 控制台、CI 管道、或启用了缓冲的终端）中会启用行缓冲或全缓冲模式，导致输出阻塞、缓冲区满后进程停滞。
✅ 推荐解决方案：绕过 RobotFramework 日志管道，由 Python 直接写入文件
无需修改 RobotFramework 配置或升级版本，只需在自定义关键字中使用原生文件 I/O：
import datetime
def log_to_file(message, log_file="robot_debug.log"):
"""安全、即时地将日志写入指定文件，避免 stdout 阻塞"""
timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
with open(log_file, "a", encoding="utf-8") as f:
f.write(f"[{timestamp}] {message}\n")
# 可选：强制刷新，确保立即落盘
with open(log_file, "r+") as f:
f.flush()
在 .robot 文件中调用：
*** Test Cases ***
Debug Log Test
Log To File Starting test step 1...
Log To File Processing item #42
Log To File Completed successfully
⚠️ 注意事项：
- 避免在 log_to_file 中使用 print() 或 BuiltIn().log() 替代写入；
- 多线程/并发测试中，建议为每个测试实例生成唯一日志文件名（如含 test_name 或 timestamp），防止写入冲突；
- 若需日志级别控制（DEBUG/INFO/WARN），可扩展函数参数，配合 logging 模块实现结构化日志；
- 此方法不替代 RobotFramework 的内置日志（如 --log 生成的 report.html），而是作为调试辅助手段，二者可共存。
该方案已在 Jenkins、GitLab CI 及 Windows/Linux 本地环境中稳定验证，有效消除因日志缓冲引发的 hang 问题，显著提升长流程测试的可靠性和可观测性。
