应使用 type(obj) is dict 严格判断是否为原生 dict，因 isinstance(obj, dict) 会误判 defaultdict、OrderedDict 等子类，导致 json.dumps 等操作异常；若只需映射行为，应优先用 isinstance(obj, collections.abc.Mapping)。
用 type() 而不是 isinstance()
最直接的办法是检查对象的**确切类型**，而不是是否“属于某个类型族”。isinstance(obj, dict) 会返回 True 对于 defaultdict、OrderedDict（在 Python 3.7+ 的 CPython 中甚至对某些子类也成立），因为它们都继承自 dict。但如果你要确认它“就是原生 dict”，就得用 type(obj) is dict。
常见错误现象：写了个配置校验函数，以为 isinstance(data, dict) 就能拦住非 dict 输入，结果传入 defaultdict(int) 也能过，后续用 data.keys() 没问题，但用 json.dumps(data) 时行为异常（比如丢失插入顺序或默认工厂被序列化失败）——这往往是因为你以为它是纯 dict，实际却不是。
-
type(obj) is dict—— 严格匹配，只对内置dict实例返回True -
isinstance(obj, dict)—— 匹配所有dict子类，包括defaultdict、OrderedDict、ChainMap（注意：ChainMap其实不继承dict，但常被误判） - 别用
obj.__class__ == dict，虽然多数时候等价，但不如is安全（避免被猴子补丁干扰）
警惕 Python 版本和实现差异
OrderedDict 在 Python 3.7+ 的 CPython 中已不是“必须用的有序字典”——因为普通 dict 已保证插入顺序。但它的类型仍是独立的：type(OrderedDict()) is OrderedDict，且 type(OrderedDict()) is not dict。这点很稳定。
真正容易踩坑的是 defaultdict：它继承自 dict，所以 isinstance(defaultdict(), dict) 是 True，但 type(defaultdict()) is dict 是 False。另外，某些第三方库（如 types.MappingProxyType）或自定义类可能伪装成 dict 行为，但连继承都不做，这时 isinstance(..., dict) 也会是 False，而你可能误以为“至少它不是 dict 子类”，其实它根本就不是 dict 的任何变体。
- CPython 3.7+ 中：
dict有序，但OrderedDict仍是不同类，保留其特殊方法（如move_to_end()） - PyPy 或旧版本中：
dict无序，OrderedDict是唯一可靠有序选项，类型区分更关键 -
defaultdict的default_factory属性是公开的，可额外检查：hasattr(obj, 'default_factory')能快速排除它（但不能代替type()判断）
需要兼容鸭子类型？那就别硬判 dict
很多场景其实并不真需要“它必须是 dict”，而是需要“它支持 keys()、items()、方括号取值”。这时候强行用 type(obj) is dict 反而限制了灵活性，比如用户传个 dataclasses.asdict() 返回的普通 dict 没问题，但传个 types.MappingProxyType 就失败——尽管它完全满足接口。
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
如果逻辑确实依赖 dict 的特定行为（例如：要求 json.dumps() 输出不含额外字段、要求没有 default_factory、要求不记录访问顺序），那才值得做严格类型判断。否则，优先用 collections.abc.Mapping 做协议检查：
from collections.abc import Mapping isinstance(obj, Mapping) and not isinstance(obj, (str, bytes))
这样既放过 dict、defaultdict、OrderedDict，也接纳 MappingProxyType 和其他符合映射协议的对象。
最保险的判断组合
如果你既要“确实是 dict”，又要防极端情况（比如有人 monkey-patch 了 dict 类），可以加一层防御：
- 先用
type(obj) is dict快速判断 - 再验证关键属性是否存在且行为一致，例如：
hasattr(obj, 'keys') and callable(obj.keys) - 避免检查
__dict__或内部属性（如_keys），这些是实现细节，跨版本不稳定
真正难处理的不是 defaultdict 或 OrderedDict，而是那些只实现了部分 dict 接口的类（比如返回 dict 但重写了 __getitem__ 来触发计算）。这种情况下，类型判断毫无意义，得靠文档或契约约定——而这类对象，通常也不该被当成普通 dict 使用。
