json_utils.py 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556
  1. """JSON 解析容错工具:从模型文本中稳健地提取与校验 JSON"""
  2. import json
  3. import re
  4. from typing import Any, Optional
  5. def parse_json_safe(text: str) -> Optional[Any]:
  6. """从模型文本中提取 JSON,解析失败返回 None
  7. 依次处理以下情况:
  8. 1. 纯 JSON 文本,直接解析;
  9. 2. ```json ... ``` 或 ``` ... ``` 代码块包裹的 JSON;
  10. 3. 前后含多余说明文本时,提取首个 {...} 或 [...] 片段。
  11. """
  12. if not text:
  13. return None
  14. raw = text.strip()
  15. # 1. 直接解析
  16. try:
  17. return json.loads(raw)
  18. except json.JSONDecodeError:
  19. pass
  20. # 2. 提取 ```json ... ``` 或 ``` ... ``` 代码块
  21. fence_pattern = re.compile(
  22. r"```(?:json)?\s*(.*?)\s*```", re.DOTALL | re.IGNORECASE
  23. )
  24. match = fence_pattern.search(raw)
  25. if match:
  26. try:
  27. return json.loads(match.group(1).strip())
  28. except json.JSONDecodeError:
  29. pass
  30. # 3. 提取首个 {...} 或 [...] 片段(去除前后多余文本)
  31. for opener, closer in (("{", "}"), ("[", "]")):
  32. start = raw.find(opener)
  33. end = raw.rfind(closer)
  34. if start != -1 and end != -1 and end > start:
  35. snippet = raw[start : end + 1]
  36. try:
  37. return json.loads(snippet)
  38. except json.JSONDecodeError:
  39. continue
  40. return None
  41. def validate_required_fields(data: Any, required_fields: list[str]) -> list[str]:
  42. """校验必填字段,返回缺失字段列表(空列表表示全部齐全)"""
  43. if not isinstance(data, dict):
  44. # 非字典结构,视为全部缺失
  45. return list(required_fields)
  46. return [f for f in required_fields if f not in data]