如何在Python中精准转换MariaDB返回的字符串化JSON对象

问题场景 #

从MariaDB获取的数据中，部分JSON对象以字符串形式返回，需要将这类真正的JSON字符串转换为JSON对象，但要排除那些仅包含引号、看起来像JSON但实际是普通文本的字符串（比如示例中的false_positive字段）。

原实现通过检查字符串是否包含双引号再尝试json.loads，会误判带引号的普通字符串；同时不想依赖“先尝试解析再捕获异常”的方式，因为部分可解析的字符串属于误判对象，不应被转换。

示例代码与问题 #

import json
results = {"not_string": 1234,
           "not_json": "1234",
           "json": '[{"json": "1234"}]',
           "false_positive": '["actually a quote in brackets"]'}

# 原实现逻辑
for key, value in results.items():
    if isinstance(value, str) and '"' in value:
        try:
            results[key] = json.loads(value)
        except Exception as e:
            pass
for key, value in results.items():
    print(type(value))

实际输出

<class 'int'>
<class 'str'>
<class 'list'>
<class 'list'>  <!-- 误判：false_positive被错误转换 -->

预期输出

<class 'int'>
<class 'str'>
<class 'list'>
<class 'str'>  <!-- 正确保留原字符串 -->

解决方案 #

核心思路是先通过JSON的结构特征过滤候选字符串，仅对符合JSON对象/数组结构的字符串尝试解析，避免误判普通文本。

改进代码 #

import json

def is_valid_json_structure(s):
    # 去除首尾空白字符，兼容数据库返回时的空格情况
    stripped_str = s.strip()
    # 判断是否为JSON对象（{}包裹）或JSON数组（[]包裹）
    return (stripped_str.startswith('{') and stripped_str.endswith('}')) or \
           (stripped_str.startswith('[') and stripped_str.endswith(']'))

results = {"not_string": 1234,
           "not_json": "1234",
           "json": '[{"json": "1234"}]',
           "false_positive": '["actually a quote in brackets"]'}

for key, value in results.items():
    if isinstance(value, str) and is_valid_json_structure(value):
        try:
            results[key] = json.loads(value)
        except json.JSONDecodeError:
            # 结构符合但解析失败，保留原字符串
            pass

# 验证结果
for key, value in results.items():
    print(f"{key}: {type(value)}")

代码说明 #

• is_valid_json_structure函数：先清理字符串首尾空白，再检查是否以{}或[]包裹——这是JSON对象/数组的标志性结构，普通文本几乎不会符合这个特征
• 仅对符合结构的字符串尝试解析，从根源上排除了false_positive这类带引号但不是JSON的普通字符串
• 即使结构符合但解析失败（比如格式错误的JSON），也会保留原字符串，避免异常影响流程

运行结果 #

not_string: <class 'int'>
not_json: <class 'str'>
json: <class 'list'>
false_positive: <class 'str'>

完全符合预期。

额外建议 #

如果你的MariaDB字段是用JSON类型存储的，可直接在查询时让数据库返回解析后的JSON（比如使用JSON_EXTRACT函数），部分数据库驱动会自动处理JSON类型的返回值，无需手动转换。

内容的提问来源于stack exchange，提问作者c8999c 3f964f64