本文详解如何正确读取、修改并写入 JSON 文件，解决因重复打开/关闭文件、错误的 JSON 序列化调用及字符串模糊匹配导致的 json.decoder.JSONDecodeError 和数据覆盖问题。
本文详解如何正确读取、修改并写入 json 文件，解决因重复打开/关闭文件、错误的 json 序列化调用及字符串模糊匹配导致的 `json.decoder.jsondecodeerror` 和数据覆盖问题。
在开发密码管理器等本地数据存储应用时，一个常见误区是试图“追加”（append）内容到 JSON 文件——但 JSON 本身不是日志格式，不支持原生追加；它要求整个文件始终为单个、完整、语法有效的 JSON 对象或数组。直接多次 open(..., 'w') 覆盖写入、在 with 块中嵌套多次文件操作、或误用 data.dump()（应为 json.dump()），都会破坏 JSON 结构，触发 JSONDecodeError。
以下是修复后的 add_info() 函数，采用原子化读-改-写流程，逻辑清晰、健壮且符合最佳实践：
def add_info():
website = website_entry.get().strip()
email_username = email_username_entry.get().strip()
password = password_entry.get().strip()
# 输入校验（基础防护）
if not all([website, email_username, password]):
messagebox.showwarning("Input Error", "All fields must be filled.")
return
data_dict = {
website: {
"email": email_username,
"password": password
}
}
try:
# ✅ 第一步：安全读取现有数据（若文件存在）
with open("data.json", "r") as data_file:
data = json.load(data_file) # 读取为 dict
except FileNotFoundError:
# 文件不存在 → 初始化为空字典
data = {}
except json.JSONDecodeError as e:
# 文件损坏 → 提示并终止，避免进一步破坏
messagebox.showerror("JSON Error", f"Invalid JSON file: {e}")
return
# ✅ 第二步：语义化检查（而非字符串搜索！）
if website in data:
messagebox.showerror("Duplicate Entry", f"Entry for '{website}' already exists.")
return
# ✅ 第三步：合并新数据
data.update(data_dict)
# ✅ 第四步：一次性安全写入（覆盖整个文件）
try:
with open("data.json", "w") as data_file:
json.dump(data, data_file, indent=4) # 注意：是 json.dump()，非 data.dump()
messagebox.showinfo("Success", "Credentials saved successfully!")
# 可选：清空表单
website_entry.delete(0, END)
email_username_entry.delete(0, END)
password_entry.delete(0, END)
except IOError as e:
messagebox.showerror("Write Error", f"Failed to save data: {e}")
关键修复点说明：
-
禁止字符串行扫描匹配：原代码
for line in data_file: if website in line:极不可靠——网站名可能出现在密码或邮箱中，导致误判或漏判。应基于解析后的 Python 字典键（website in data）做精确判断。 -
消除嵌套
with块与重复文件操作：原逻辑在try中打开文件读取，又在else中再次打开读写，最后finally还强制重读重写，极易引发ValueError: I/O operation on closed file或写入空/损坏内容。 -
修正 JSON 序列化调用：
data.dump(...)是错误写法（dict没有dump方法），必须使用json.dump(data, file_obj, ...)。 -
强化异常处理：区分
FileNotFoundError（首次保存）、JSONDecodeError（文件被手动编辑损坏）、IOError（磁盘满/权限不足），提供明确反馈。 - 添加输入校验与用户体验优化：防止空提交，并在成功后清空表单。
⚠️ 重要注意事项：
- JSON 不是数据库：如需高频增删查改、并发访问或海量数据，应迁移到 SQLite（Python 内置）或轻量级数据库。
-
线程/进程安全：当前方案在多线程下仍存在竞态风险（读-改-写非原子）。生产环境建议加文件锁（
threading.Lock或portalocker）。 -
敏感数据加密：纯文本存储密码存在严重安全隐患。务必集成
cryptography库实现 AES 加密（主密码派生密钥），本文聚焦 JSON I/O 问题，安全存储需另行实现。
遵循以上结构，你的密码管理器将稳定、可靠地持久化数据，彻底告别 JSONDecodeError。
