如何访问嵌套 JSON 深层字段

本文详解 Python 中读取 JSON 文件后访问多层嵌套键（如 json_map['epapconfig']['Display']['suffix']）时出现 'int' object is not subscriptable 错误的成因与解决方案，涵盖加载、验证、安全访问全流程。

本文详解 Python 中读取 JSON 文件后访问多层嵌套键（如 `json_map['epapconfig']['Display']['suffix']`）时出现 `'int' object is not subscriptable` 错误的成因与解决方案，涵盖加载、验证、安全访问全流程。

在 Python 中解析 JSON 数据后无法访问嵌套字段（例如 json_map['epapconfig']['Display']['suffix']），并报错 TypeError: 'int' object is not subscriptable，根本原因通常不是 JSON 结构本身有问题，而是变量被意外覆写为整数类型——最常见的情况是：你曾用 json_map = 0、json_map = 1 或类似语句重定义了该变量，导致后续尝试用方括号索引时实际操作的是一个整数。

以下是一个完整、健壮的访问示例：

import json

# ✅ 正确方式：从字符串或文件加载 JSON
json_str = '''{
    "epapconfig": {
        "suffix": "Enter Choice: ",
        "Display": {
            "suffix": "Press return to continue..."
        },
        "Security": {
            "suffix": "Enter Choice: ",
            "Timeout": {
                "suffix": "Enter Choice: ",
                "Display": {
                    "suffix": "Press return to continue..."
                }
            }
        }
    },
    "epapdev": {"suffix": "]$ "},
    "su": {"suffix": "Password: "},
    "root": {"suffix": "]# "}
}'''

# 加载为字典
json_map = json.loads(json_str)

# 安全访问嵌套字段（推荐）
try:
    suffix = json_map['epapconfig']['Display']['suffix']
    print("Display suffix:", suffix)  # 输出：Press return to continue...
except KeyError as e:
    print(f"缺失必要键: {e}")
except TypeError as e:
    print(f"类型错误 —— 可能 json_map 不是字典: {e}")

⚠️ 关键注意事项：

• 切勿使用 dict 作为变量名（如 dict = {...}），它会覆盖内置 dict 类型，引发隐性问题；应使用 config, data, json_map 等语义化名称。
• 检查变量类型：在访问前添加 print(type(json_map)) 和 print(json_map.keys())，确认其为 dict 且包含预期键。
• 防御性编程：对不确定存在的嵌套层级，建议使用 .get() 链式调用或 jsonpath-ng 库，例如：

  suffix = (json_map
            .get('epapconfig', {})
            .get('Display', {})
            .get('suffix', 'DEFAULT_SUFFIX'))

✅ 总结：该错误几乎总是源于变量类型被意外篡改（如赋值为 int），而非 JSON 格式问题。务必确保 json_map 始终为 dict 类型，并通过 isinstance(json_map, dict) 进行校验，再进行嵌套访问。