Flask REST API：优雅处理模型NULL字段返回JSON的方法

嘿，这个场景我太熟悉了——返回JSON时带着null确实不太美观，甚至可能给前端带来不必要的判断麻烦。这里有几种优雅的解决方式，你可以根据项目规模和需求来选：

1. 直接在json()方法里处理（简单快捷） #

最直接的方式就是在构造返回字典时，对每个可能为None的字段做判断。两种实现思路供你参考：

方式A：用or运算符（适合无合法假值的字段） #

如果你的字段不会出现0、False这类“假值”，直接用or就能快速把None替换为空字符串：

def json(self):
    return { 
        'username': self.username or '', 
        'fullname': self.fullname or ''
    }

方式B：三元表达式（更严谨） #

如果字段可能包含合法的假值（比如数字类型的0），用三元表达式只针对None做替换，避免误改有效数据：

def json(self):
    return { 
        'username': self.username if self.username is not None else '', 
        'fullname': self.fullname if self.fullname is not None else ''
    }

2. 封装通用工具函数（复用性高） #

如果多个模型都有这种NULL替换需求，写个通用函数来处理字段，避免重复写判断逻辑：

def get_field_value(value, default=''):
    """将None替换为指定默认值，其他值保持原样"""
    return value if value is not None else default

# 在UserModel的json方法里调用
def json(self):
    return { 
        'username': get_field_value(self.username), 
        'fullname': get_field_value(self.fullname, default='未设置')  # 支持自定义默认值
    }

3. 用序列化库（大型项目首选） #

如果你的API逻辑比较复杂，推荐用Flask-Marshmallow这类序列化库，它能统一管理序列化规则，包括默认值、字段过滤、格式校验等，后期维护更省心：

首先安装依赖：

pip install flask-marshmallow marshmallow-sqlalchemy

然后定义Schema并使用：

from marshmallow import Schema, fields

class UserSchema(Schema):
    username = fields.Str(default='')  # 字段为None时返回空字符串
    fullname = fields.Str(default='')

# 实例化Schema
user_schema = UserSchema()

# 修改UserModel的json方法
def json(self):
    return user_schema.dump(self)

这种方式的优势在于，后续如果要修改序列化规则、添加新字段或过滤敏感字段（比如你的password），只需要调整Schema即可，不用逐个修改模型的json方法。

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