Python运行时如何判断对象是否可JSON序列化？

Python里没有内置的"魔法字段"直接判断对象是否能被JSON序列化，但可以通过两种思路实现需求：

1. 预定义可序列化类型+异常捕获（最可靠） #

JSON原生支持的类型包括str、int、float、bool、None、list、dict，但自定义对象或特殊类型（比如module）不在此列。最稳妥的方式是先判断基础类型，再尝试序列化来验证：

import json
from typing import Any

# JSON原生支持的基础类型
JSON_BASE_TYPES = (str, int, float, bool, type(None), list, dict)

def is_json_friendly(obj: Any) -> bool:
    # 基础类型直接判定为可序列化
    if isinstance(obj, JSON_BASE_TYPES):
        return True
    # 非基础类型尝试序列化，无异常则判定为可序列化
    try:
        json.dumps(obj)
        return True
    except (TypeError, OverflowError):
        return False

2. 自定义安全序列化函数 #

结合上面的判断函数，你可以实现自动处理不可序列化对象的方法：

def safe_json_serialize(obj: Any) -> str:
    if is_json_friendly(obj):
        return json.dumps(obj)
    # 不可序列化时转为字符串再序列化
    return json.dumps(str(obj))

补充：针对性排除特殊类型 #

如果不想用try-except（比如对性能有要求），可以针对性排除已知不可序列化的类型，比如module：

import types

def is_json_friendly(obj: Any) -> bool:
    if isinstance(obj, JSON_BASE_TYPES):
        return True
    # 排除module类型
    if isinstance(obj, types.ModuleType):
        return False
    # 其他自定义对象可以尝试判断是否能转为字典（仅适用于常规类实例）
    if hasattr(obj, "__dict__"):
        return all(is_json_friendly(v) for v in obj.__dict__.values())
    return False

这种方式性能更高，但覆盖范围不如try-except全面，因为还有很多其他不可序列化的特殊类型（如文件对象、线程对象等）。

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