MetaGPT项目中的JSON格式修复问题分析与解决方案

背景介绍

在使用MetaGPT项目时，开发人员遇到了一个关于JSON格式解析的问题。当LLM(大语言模型)生成的JSON内容中包含不符合规范的语法结构时，MetaGPT内置的修复机制无法正确处理这些异常情况，导致程序最终报错退出。

问题现象

在运行MetaGPT时，系统日志显示JSON解析失败，主要报错信息为"Expecting ':' delimiter"。经过分析，发现问题的根源在于LLM生成的JSON内容中存在两处不符合JSON规范的结构：

1. 集合/列表使用了花括号而非方括号：JSON规范中，数组/列表应使用方括号[]包裹，而对象/字典才使用花括号{}包裹键值对。但在LLM输出中，某些列表错误地使用了花括号。

2. 字符串使用了加号连接：JSON规范不支持使用加号+连接字符串，而LLM生成的JSON中却出现了这种编程语言风格的字符串连接方式。

技术分析

JSON作为一种轻量级的数据交换格式，有着严格的语法要求。当LLM生成的输出不符合这些规范时，标准的JSON解析器会抛出异常。MetaGPT虽然内置了repair_invalid_json函数来尝试修复这类问题，但在面对上述特定情况时，修复机制未能奏效。

具体来看，问题JSON中的异常结构包括：

• 类图定义中的方法列表错误地使用了花括号{}而非方括号[]
• 序列图中使用了编程语言风格的字符串连接符+而非JSON标准的字符串拼接方式

解决方案

针对这一问题，可以采取以下修复策略：

1. 花括号替换为方括号：

   • 当解析器报错提示缺少:分隔符时
   • 定位到错误位置前后的花括号{}
   • 将其替换为方括号[]

2. 字符串连接符替换：

   • 检测行末的加号+
   • 将其替换为逗号,
   • 确保字符串连接符合JSON规范

实施建议

对于MetaGPT项目开发者，建议在repair_invalid_json函数中增加针对这两种特殊情况的处理逻辑。同时，也可以考虑：

1. 在LLM提示词中明确要求输出严格符合JSON规范
2. 增加更全面的JSON语法校验和修复机制
3. 对常见LLM输出格式问题进行模式识别和自动修正

总结

LLM生成内容时偶尔会出现不符合目标格式规范的情况，这在使用MetaGPT等基于LLM的开发框架时尤为常见。通过分析具体的JSON解析失败案例，我们不仅找到了问题的根源，还提出了针对性的修复方案。这类问题的解决不仅提升了框架的健壮性，也为处理类似格式问题提供了参考思路。