Python檢查JSON格式錯(cuò)誤的多種方法

更新時(shí)間：2026年02月15日 08:22:28 作者：detayun

文章介紹了7種處理JSON格式問題的方法,包括使用標(biāo)準(zhǔn)庫、JSON錯(cuò)誤診斷工具、逐行驗(yàn)證、jsonschema驗(yàn)證、命令行工具、在線驗(yàn)證工具和IDE內(nèi)置功能,建議對于股票數(shù)據(jù)場景,使用這些方法可以快速定位和修復(fù)JSON格式問題,需要的朋友可以參考下

方法1：使用標(biāo)準(zhǔn)庫json.loads()捕獲異常（最常用）
方法2：詳細(xì)的JSON錯(cuò)誤診斷工具
方法3：逐行驗(yàn)證大JSON文件
方法4：使用jsonschema驗(yàn)證JSON結(jié)構(gòu)
方法5：命令行工具方式
方法6：在線驗(yàn)證和格式化工具
方法7：使用IDE內(nèi)置功能
實(shí)用調(diào)試技巧
推薦方案總結(jié)

方法1：使用標(biāo)準(zhǔn)庫json.loads()捕獲異常（最常用）

import json

def validate_json(json_str):
    """
    驗(yàn)證JSON字符串格式是否正確
    """
    try:
        json.loads(json_str)
        return True, None
    except json.JSONDecodeError as e:
        return False, e

# 使用示例
test_cases = [
    '{"name": "張三", "age": 25}',  # 正確
    '{"name": "張三", "age": 25',   # 缺少右括號
    "{'name': '張三'}",             # 單引號錯(cuò)誤
    '{"name": "張三", "age": }',    # 缺少值
]

for i, json_str in enumerate(test_cases):
    is_valid, error = validate_json(json_str)
    print(f"\n測試 {i+1}: {repr(json_str[:50])}")
    if is_valid:
        print("? JSON格式正確")
    else:
        print(f"? JSON格式錯(cuò)誤: {error.msg}")
        print(f"  位置: 第{error.lineno}行, 第{error.colno}列")
        print(f"  上下文: {repr(error.doc[max(0, error.pos-20):error.pos+20])}")

方法2：詳細(xì)的JSON錯(cuò)誤診斷工具

import json
import re

class JSONValidator:
    """JSON格式驗(yàn)證器，提供詳細(xì)錯(cuò)誤信息"""
    
    @staticmethod
    def validate(json_str, verbose=True):
        """
        驗(yàn)證JSON并返回詳細(xì)信息
        """
        errors = []
        
        # 檢查1: 是否為空
        if not json_str or not json_str.strip():
            errors.append("JSON字符串為空")
            return False, errors
        
        # 檢查2: 嘗試解析
        try:
            data = json.loads(json_str)
            return True, ["JSON格式正確"]
        except json.JSONDecodeError as e:
            errors.append(f"解析錯(cuò)誤: {e.msg}")
            errors.append(f"位置: 行{e.lineno}, 列{e.colno}")
            errors.append(f"字符位置: {e.pos}")
            
            # 顯示錯(cuò)誤上下文
            context_start = max(0, e.pos - 30)
            context_end = min(len(json_str), e.pos + 30)
            context = json_str[context_start:context_end]
            errors.append(f"上下文: ...{context}...")
            
            # 標(biāo)記錯(cuò)誤位置
            marker = ' ' * (e.pos - context_start) + '^'
            errors.append(f"標(biāo)記:   {marker}")
            
            # 檢查3: 常見格式問題
            if "'" in json_str and '"' not in json_str:
                errors.append("警告: 檢測到單引號，JSON應(yīng)使用雙引號")
            
            if json_str.startswith("'") or json_str.startswith('"'):
                # 檢查是否有BOM標(biāo)記
                if json_str.startswith('\ufeff'):
                    errors.append("警告: 檢測到BOM標(biāo)記")
            
            # 檢查4: 括號匹配
            bracket_stack = []
            for i, char in enumerate(json_str):
                if char in '{[(':
                    bracket_stack.append((char, i))
                elif char in '}])':
                    if not bracket_stack:
                        errors.append(f"錯(cuò)誤: 位置{i}處有未匹配的閉合括號'{char}'")
                        break
                    opening, pos = bracket_stack.pop()
                    if (opening == '{' and char != '}') or \
                       (opening == '[' and char != ']') or \
                       (opening == '(' and char != ')'):
                        errors.append(f"錯(cuò)誤: 位置{pos}的'{opening}'與位置{i}的'{char}'不匹配")
            
            if bracket_stack:
                for opening, pos in bracket_stack:
                    errors.append(f"錯(cuò)誤: 位置{pos}的'{opening}'沒有閉合")
            
            return False, errors
    
    @staticmethod
    def pretty_print_errors(json_str):
        """
        美觀地打印JSON錯(cuò)誤信息
        """
        is_valid, errors = JSONValidator.validate(json_str)
        
        print("=" * 60)
        print("JSON格式檢查結(jié)果")
        print("=" * 60)
        print(f"輸入: {repr(json_str[:100])}")
        print(f"狀態(tài): {'? 通過' if is_valid else '? 失敗'}")
        print("-" * 60)
        
        for error in errors:
            print(f"  {error}")
        
        print("=" * 60)
        return is_valid

# 使用示例
if __name__ == "__main__":
    # 測試各種錯(cuò)誤情況
    test_json = """
    {"name": "張三", "age": 25, "city": "北京"  # 缺少右括號
    """
    
    JSONValidator.pretty_print_errors(test_json)
    
    print("\n" + "=" * 60)
    print("測試正確的JSON")
    print("=" * 60)
    correct_json = '{"name": "張三", "age": 25, "city": "北京"}'
    JSONValidator.pretty_print_errors(correct_json)

方法3：逐行驗(yàn)證大JSON文件

import json

def validate_json_file(filepath):
    """
    驗(yàn)證JSON文件格式
    """
    try:
        with open(filepath, 'r', encoding='utf-8') as f:
            content = f.read()
            json.loads(content)
        print(f"? {filepath} 格式正確")
        return True
    except json.JSONDecodeError as e:
        print(f"? {filepath} 格式錯(cuò)誤:")
        print(f"  錯(cuò)誤: {e.msg}")
        print(f"  位置: 行{e.lineno}, 列{e.colno}")
        
        # 顯示錯(cuò)誤行
        with open(filepath, 'r', encoding='utf-8') as f:
            lines = f.readlines()
            if e.lineno <= len(lines):
                print(f"  錯(cuò)誤行: {e.lineno}: {lines[e.lineno-1].rstrip()}")
                # 標(biāo)記錯(cuò)誤位置
                marker = ' ' * (e.colno - 1) + '^'
                print(f"           {marker}")
        return False
    except FileNotFoundError:
        print(f"? 文件不存在: {filepath}")
        return False

# 使用示例
# validate_json_file('data.json')

方法4：使用jsonschema驗(yàn)證JSON結(jié)構(gòu)

import json
from jsonschema import validate, ValidationError, SchemaError

def validate_json_structure(json_str, schema=None):
    """
    驗(yàn)證JSON結(jié)構(gòu)是否符合預(yù)期
    """
    try:
        data = json.loads(json_str)
    except json.JSONDecodeError as e:
        return False, f"JSON格式錯(cuò)誤: {e.msg}"
    
    # 如果提供了schema，驗(yàn)證結(jié)構(gòu)
    if schema:
        try:
            validate(instance=data, schema=schema)
            return True, "JSON結(jié)構(gòu)正確"
        except ValidationError as e:
            return False, f"結(jié)構(gòu)驗(yàn)證失敗: {e.message}"
        except SchemaError as e:
            return False, f"Schema錯(cuò)誤: {e.message}"
    
    return True, "JSON格式正確"

# 使用示例
schema = {
    "type": "object",
    "properties": {
        "name": {"type": "string"},
        "age": {"type": "number"},
        "email": {"type": "string", "format": "email"}
    },
    "required": ["name", "age"]
}

json_str = '{"name": "張三", "age": 25, "email": "zhangsan@example.com"}'
is_valid, message = validate_json_structure(json_str, schema)
print(f"{message}: {is_valid}")

方法5：命令行工具方式

# 保存為 validate_json.py
import json
import sys
import argparse

def main():
    parser = argparse.ArgumentParser(description='JSON格式驗(yàn)證工具')
    parser.add_argument('file', nargs='?', help='JSON文件路徑')
    parser.add_argument('-s', '--string', help='JSON字符串')
    parser.add_argument('-v', '--verbose', action='store_true', help='詳細(xì)輸出')
    
    args = parser.parse_args()
    
    # 從文件或字符串讀取
    if args.file:
        with open(args.file, 'r', encoding='utf-8') as f:
            json_str = f.read()
        source = f"文件: {args.file}"
    elif args.string:
        json_str = args.string
        source = "字符串"
    else:
        # 從stdin讀取
        json_str = sys.stdin.read()
        source = "標(biāo)準(zhǔn)輸入"
    
    # 驗(yàn)證
    try:
        data = json.loads(json_str)
        print(f"? {source}: JSON格式正確")
        if args.verbose:
            print(f"  類型: {type(data)}")
            if isinstance(data, dict):
                print(f"  鍵數(shù)量: {len(data)}")
            elif isinstance(data, list):
                print(f"  元素?cái)?shù)量: {len(data)}")
        sys.exit(0)
    except json.JSONDecodeError as e:
        print(f"? {source}: JSON格式錯(cuò)誤", file=sys.stderr)
        print(f"  錯(cuò)誤: {e.msg}", file=sys.stderr)
        print(f"  位置: 行{e.lineno}, 列{e.colno}", file=sys.stderr)
        
        if args.verbose:
            # 顯示上下文
            lines = json_str.split('\n')
            if e.lineno <= len(lines):
                print(f"\n  錯(cuò)誤行 {e.lineno}:", file=sys.stderr)
                print(f"    {lines[e.lineno-1]}", file=sys.stderr)
                marker = ' ' * (e.colno - 1) + '^'
                print(f"    {marker}", file=sys.stderr)
        
        sys.exit(1)

if __name__ == '__main__':
    main()

使用方式：

# 驗(yàn)證文件
python validate_json.py data.json

# 驗(yàn)證字符串
python validate_json.py -s '{"name": "test"}'

# 詳細(xì)模式
python validate_json.py -v data.json

# 從管道讀取
echo '{"name": "test"}' | python validate_json.py

方法6：在線驗(yàn)證和格式化工具

如果不想寫代碼，可以使用這些工具：

JSONLint: https://jsonlint.com/
JSON Formatter: https://jsonformatter.curiousconcept.com/
VS Code插件: JSON相關(guān)插件

方法7：使用IDE內(nèi)置功能

VS Code:

安裝 “JSON” 相關(guān)擴(kuò)展
.json 文件自動(dòng)驗(yàn)證
快捷鍵: Ctrl+Space 提示

PyCharm:

內(nèi)置JSON驗(yàn)證
自動(dòng)格式化: Ctrl+Alt+L
語法高亮顯示錯(cuò)誤

實(shí)用調(diào)試技巧

import json
import traceback

def debug_json_error(json_str):
    """
    調(diào)試JSON錯(cuò)誤的實(shí)用函數(shù)
    """
    print("=" * 70)
    print("JSON調(diào)試信息")
    print("=" * 70)
    print(f"長度: {len(json_str)} 字符")
    print(f"前100字符: {repr(json_str[:100])}")
    print(f"后100字符: {repr(json_str[-100:])}")
    
    # 檢查常見問題
    checks = [
        ("是否為空", lambda s: not s.strip()),
        ("是否以單引號開頭", lambda s: s.strip().startswith("'")),
        ("是否包含單引號", lambda s: "'" in s and '"' not in s),
        ("是否有BOM標(biāo)記", lambda s: s.startswith('\ufeff')),
        ("括號是否匹配", lambda s: s.count('{') != s.count('}') or s.count('[') != s.count(']')),
    ]
    
    print("\n初步檢查:")
    for check_name, check_func in checks:
        result = check_func(json_str)
        status = "? 可能有問題" if result else "? 正常"
        print(f"  {check_name}: {status}")
    
    # 嘗試解析
    print("\n解析嘗試:")
    try:
        data = json.loads(json_str)
        print(f"? 解析成功!")
        print(f"  類型: {type(data)}")
        if isinstance(data, dict):
            print(f"  鍵: {list(data.keys())[:5]}")
        return True
    except json.JSONDecodeError as e:
        print(f"? 解析失敗!")
        print(f"  錯(cuò)誤信息: {e.msg}")
        print(f"  位置: 行{e.lineno}, 列{e.colno}")
        
        # 顯示詳細(xì)上下文
        print(f"\n  錯(cuò)誤位置上下文:")
        start = max(0, e.pos - 50)
        end = min(len(json_str), e.pos + 50)
        context = json_str[start:end]
        print(f"    ...{context}...")
        
        # 標(biāo)記位置
        marker_pos = e.pos - start
        marker = ' ' * marker_pos + '^'
        print(f"    {' ' * (marker_pos)}{marker}")
        
        # 顯示周圍幾行
        print(f"\n  周圍行:")
        lines = json_str.split('\n')
        for i in range(max(0, e.lineno-2), min(len(lines), e.lineno+2)):
            prefix = "  > " if i == e.lineno-1 else "    "
            print(f"    {prefix}行{i+1}: {repr(lines[i][:100])}")
        
        return False
    finally:
        print("=" * 70)

# 使用示例
if __name__ == "__main__":
    # 測試有問題的JSON
    bad_json = '''
    {
        "name": "張三",
        'age': 25,  # 這里用了單引號
        "city": "北京"
    }
    '''
    
    debug_json_error(bad_json)