robotframework 在执行过程中常因日志输出机制导致卡顿，尤其在生成大量日志（如第30行左右）时出现无响应。本文提供一种绕过 robotframework 日志系统的轻量级方案：由 python 脚本直接写入日志文件，彻底规避其内置日志缓冲与重定向引发的阻塞问题。
robotframework 在执行过程中常因日志输出机制导致卡顿，尤其在生成大量日志（如第30行左右）时出现无响应。本文提供一种绕过 robotframework 日志系统的轻量级方案：由 python 脚本直接写入日志文件，彻底规避其内置日志缓冲与重定向引发的阻塞问题。
RobotFramework 默认将 print() 或 sys.stdout.write() 输出捕获并重定向至其内部日志系统（如 log.html 和控制台），该机制在高频率、大批量日志写入时可能因同步锁、缓冲区满或 UI 渲染延迟而造成进程挂起（hang），典型表现为脚本在某一行（如第30行）后长时间无响应，CPU 占用极低，且 --loglevel DEBUG 也无法缓解。
✅ 推荐解决方案：绕过 RobotFramework 日志层，由 Python 直接写入文件
在关键字实现或自定义库中，避免使用 print() 或 BuiltIn().log()，改用标准文件 I/O 写入独立日志文件：
import datetime
def log_to_file(message, filename="custom_debug.log"):
timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
with open(filename, "a", encoding="utf-8") as f:
f.write(f"[{timestamp}] {message}\n")
在 RobotFramework 测试用例中调用：
*** Keywords ***
Log Debug Info
Log To File This is a high-frequency debug message
⚠️ 注意事项：
- 确保日志文件路径有写入权限，生产环境建议使用绝对路径或 os.path.join(OUTPUT_DIR, "debug.log")（可通过 BuiltIn().get_variable_value("${OUTPUT_DIR}") 获取 Robot 输出目录）；
- 避免在循环中频繁打开/关闭同一文件——应复用文件句柄或使用 logging 模块配置 FileHandler 实现高效异步写入；
- 若需与 Robot 日志时间轴对齐，可在消息中显式添加 datetime.now() 时间戳；
- 此方法不替代 Robot 的结构化日志（如关键字层级、截图、变量快照），仅用于调试追踪；关键业务日志仍建议通过 BuiltIn().log() 记录。
? 总结：当 RobotFramework 出现“日志行数阈值型卡顿”（如稳定停在第30、100、500行），大概率是其日志子系统瓶颈所致。采用 Python 原生文件写入是一种零依赖、高可控、立竿见影的 workaround，既保持测试逻辑完整性，又显著提升执行稳定性与可观测性。
