Discord聊天管理机器人JSONDecodeError错误排查求助

错误原因解析 #

json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0) 本质是json.load()读取的内容不是有效JSON格式，最常见触发场景：

• users.json文件为空（字节数为0）
• 文件路径错误，读取到不存在的文件（部分open模式会自动创建空文件）
• 文件内容存在语法错误（但第1行第1列报错，空文件概率最高）

排查与修复步骤 #

1. 检查文件本身 #

• 找到users.json所在位置，确认文件大小是否大于0：
  • 若为空，手动写入初始有效JSON结构：

    {}
    

  • 若文件非空，检查是否存在未闭合引号、多余逗号等语法问题。

2. 修正读取逻辑 #

错误读取示例（文件不存在时会创建空文件，直接导致解码失败）：

import json

with open('users.json', 'w+') as f:
    data = json.load(f)

正确处理逻辑（先判断文件状态，不存在则初始化）：

import json
import os

def load_user_data():
    # 检查文件存在且非空
    if os.path.exists('users.json') and os.path.getsize('users.json') > 0:
        with open('users.json', 'r') as f:
            try:
                return json.load(f)
            except json.JSONDecodeError:
                # 备份损坏文件并返回初始数据
                os.rename('users.json', 'users_error_backup.json')
                return {}
    else:
        # 创建初始空JSON文件
        with open('users.json', 'w') as f:
            json.dump({}, f)
        return {}

# 加载数据
user_records = load_user_data()

3. 确认文件路径正确性 #

若脚本与users.json不在同一目录，使用绝对路径避免读取错误：

script_dir = os.path.dirname(os.path.abspath(__file__))
file_path = os.path.join(script_dir, 'users.json')
# 后续操作使用file_path替代'users.json'

4. 规范写入逻辑 #

写入数据时确保格式正确，避免损坏文件：

def save_user_data(data):
    with open('users.json', 'w') as f:
        json.dump(data, f, indent=4)  # indent让JSON格式化，降低语法错误概率

内容的提问来源于stack exchange，提问作者SiriyiuS