Python 使用 json-repair 修复大模型返回的非法 JSON

从文件或文件描述符中读取

import json_repair

try:
    file_descriptor = open(fname, 'rb')
except OSError:
    pass

with file_descriptor:
    decoded_object = json_repair.load(file_descriptor)

更简洁的方式：

import json_repair

try:
    decoded_object = json_repair.from_file(json_file)
except (OSError, IOError):
    pass

非拉丁字符处理

处理中文等非拉丁字符时，需传递 ensure_ascii=False 以保留原字符。

# 默认会转义
repair_json("{'test_chinese_ascii':'统一码'}")
# 保留原字符
repair_json("{'test_chinese_ascii':'统一码'}", ensure_ascii=False)

提升性能

• 设置 return_objects=True 总是更快，因为解析器直接返回对象。
• 设置 skip_json_loads=True 仅在确定字符串不是有效 JSON 时更快。
• 转义字符串建议使用原始字符串：r"string with escaping\""。

from json_repair import repair_json
good_json_string = repair_json(bad_json_string, skip_json_loads=True)

严格模式

默认情况下，json_repair 尽力修复输入数据。如需报错而非修复，启用 strict=True。

from json_repair import repair_json
repair_json(bad_json_string, strict=True)

在严格模式下，遇到重复键、缺失分隔符等问题会抛出 ValueError。结合 skip_json_loads=True 可跳过初始检查同时执行严格规则。

流式修复

传输数据时可使用 stream_stable=True 实现流式修复。

stream_output = repair_json(stream_input, stream_stable=True)

CLI 使用

$ json_repair -h
usage: json_repair [-h] [-i] [-o TARGET] [--ensure_ascii] [--indent INDENT]
                   [--skip-json-loads] [--schema SCHEMA] [--schema-model MODEL]
                   [--strict] [filename]

positional arguments:
  filename      The JSON file to repair
options:
  --strict      Raise on duplicate keys, missing separators...

Java 版本

依赖：

<dependency>
    <groupId>io.github.du00cs</groupId>
    <artifactId>json-repairj</artifactId>
    <version>0.50.0</version>
</dependency>

使用示例：

import org.jsonrepairj.JsonRepair;
import org.jsonrepairj.ParseResult;

public class Test {
    public static void main(String[] args) {
        String str = "你好，这是我按照 json 格式返回的数据：{\"name\": \"约翰\", \"age\": 30, \"city\": \"New York\"";
        
        // 修复 json
        String result = JsonRepair.repairJson(str);
        System.out.println(result);
        
        // 更多控制
        ParseResult result2 = JsonRepair.parseJson(str, true, false);
        System.out.println(result2.getJson().toString());
    }
}