如何安全访问嵌套 JSON 数据并避免 KeyError 异常_网络技术

本文讲解如何在 python 中安全访问 api 返回的嵌套 json 字段（如 `normaltime`、`period1` 等），通过 `.get()` 方法优雅处理缺失键，防止 `keyerror` 中断程序，并提供默认值（如 `999`）或合理回退逻辑。

在调用 SofaScore 等第三方体育 API 时，常见问题之一是：部分比赛数据尚未生成（例如未开赛或已取消），导致 homeScore 或 awayScore 对象中缺少 normaltime、period1 等字段。直接使用 game['homeScore']['normaltime'] 会触发 KeyError: 'normaltime'，程序立即崩溃。

根本原因在于——Python 字典的方括号语法 d[key] 要求键必须存在，否则抛出异常；而更健壮的做法是使用 .get(key, default) 方法：它在键不存在时返回 None（或你指定的默认值），而非报错。

以下为优化后的核心实践：

✅ 正确做法：逐层使用 .get() 安全取值
对任意可能缺失的嵌套层级（如 game → homeScore → normaltime），均应链式调用 .get()，并设置合理默认值。例如：

homescore = game.get("homeScore", {}).get("normaltime", 999)
awayscore = game.get("awayScore", {}).get("normaltime", 999)
homehalf = game.get("homeScore", {}).get("period1", 0)   # 上半场比分默认为 0
awayhalf = game.get("awayScore", {}).get("period1", 0)

⚠️ 注意命名冲突：避免覆盖内置函数
原代码中使用 round = game['roundInfo']['round'] 将变量命名为 round，这会覆盖 Python 内置函数 round()，可能导致后续数值四舍五入等操作异常。应改用 game_round 或 round_name 等语义化名称。

✅ 安全提取赛事轮次信息（含多级 fallback）
roundInfo 本身也可能为空，因此需先检查其存在性，再取子字段：

round_info = game.get("roundInfo")
if round_info:
    round_name = round_info.get("name") or f"Round {round_info.get('round', '?')}"
else:
    round_name = "Not Scheduled"

? 完整修复示例（含时间格式化与错误兜底）：

from datetime import datetime
import requests
import json

url = "https://api.sofascore.com/api/v1/sport/football/scheduled-events/2025-02-01"
headers = {
    "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
    "origin": "https://www.sofascore.com",
    "referer": "https://www.sofascore.com/",
}

response = requests.get(url, headers=headers)
jsondata = response.json()

for game in jsondata.get("events", []):
    try:
        league = game.get("tournament", {}).get("name", "Unknown League")
        hometeam = game.get("homeTeam", {}).get("name", "N/A")
        awayteam = game.get("awayTeam", {}).get("name", "N/A")

        # 安全获取比分（缺失时返回 999）
        homescore = game.get("homeScore", {}).get("normaltime", 999)
        awayscore = game.get("awayScore", {}).get("normaltime", 999)
        homehalf = game.get("homeScore", {}).get("period1", 0)
        awayhalf = game.get("awayScore", {}).get("period1", 0)

        # 安全获取开始时间
        timestamp = game.get("startTimestamp")
        time_str = datetime.fromtimestamp(timestamp).strftime("%H:%M") if timestamp else "TBD"

        # 安全获取轮次
        round_info = game.get("roundInfo", {})
        round_name = round_info.get("name") or f"Round {round_info.get('round', '?')}"

        print(f"{league} | {hometeam} - {awayteam} ({homehalf}-{awayhalf}) {homescore}-{awayscore} | {time_str} | {round_name}")

    except Exception as e:
        print(f"[Warning] Failed to parse game: {e}")
        continue

? 关键总结：

✅ 永远对第三方 API 响应做防御性编程：假设任何字段都可能缺失；
✅ 优先使用 .get(key, default) 替代 ['key']；
✅ 对嵌套结构（如 game['homeScore']['normaltime']）务必分步 .get()，并在中间层提供空字典 {} 作为 fallback；
✅ 避免使用 round、list、str 等内置名作变量；
✅ 添加 try...except 包裹单条记录解析，确保一条失败不影响整体流程。

这样即可稳定运行，无论数据是否完整。

# python # js # json # windows # app # ai # win # apple # 常见问题

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】