解决promptfoo评估结果保存时的循环引用JSON转换错误

在promptfoo项目的最新版本(v0.107.4)中，用户在使用Node包进行模型评估时遇到了一个技术问题。当尝试保存评估结果时，系统会抛出"Converting circular structure to JSON"的错误提示，导致评估过程无法正常完成。

问题现象分析

这个错误的核心在于JavaScript对象中存在循环引用结构。具体报错信息显示，问题起源于TLSSocket对象和HTTPParser对象之间的相互引用关系。当系统尝试将这些对象序列化为JSON格式时，由于存在对象A引用对象B，而对象B又反过来引用对象A的循环结构，JSON.stringify()方法无法处理这种循环引用，因此抛出类型错误。

技术背景

在JavaScript中，JSON.stringify()方法用于将JavaScript值转换为JSON字符串。然而，当对象图中存在循环引用时，这个方法就会失败。循环引用指的是对象属性之间形成了一个闭环，例如：

• 对象A有一个属性指向对象B
• 对象B又有一个属性指回对象A

这种结构在Node.js的网络相关对象中很常见，比如TLSSocket和HTTPParser之间的相互引用。

解决方案

promptfoo开发团队已经识别并修复了这个问题。修复方案主要涉及以下几个方面：

1. 在序列化评估结果时，对可能包含循环引用的对象进行特殊处理
2. 使用自定义的序列化方法替代默认的JSON.stringify()
3. 过滤掉不需要保存的内部对象属性

最佳实践建议

对于使用promptfoo进行模型评估的开发者，建议：

1. 及时更新到包含修复的版本
2. 在自定义评估配置中，避免在provider配置中包含可能引起循环引用的复杂对象
3. 对于需要保存的复杂数据结构，考虑实现自定义的toJSON()方法

总结

这个问题的出现提醒我们，在处理复杂对象序列化时需要考虑循环引用的情况。promptfoo团队快速响应并修复了这个问题，确保了评估结果的正常保存功能。开发者只需等待包含修复的新版本发布并升级即可解决此问题。