Flask返回None并设置HTTP 204响应的问题求助

问题背景 #

我用Flask开发RestfulAPI，前端通过React发送请求，希望注册接口返回HTTP 204（No Content）的空响应。现有注册接口代码如下：

@register_bp.route('/auth/register', methods=['POST'])
def register():
    register_dto = RegisterDTO.from_dict(request.get_json())
    user: User = UsersConverter.convert_register_dto_to_entity(register_dto)
    if UserDbMethods.does_user_with_username_exist(user.username):
        raise DuplicatedException('This username is used, please choose other username')
    if UserDbMethods.does_user_with_email_exist(user.email):
        raise DuplicatedException('This email is used by another username.')
    if not AuthUtils.is_strong_password(register_dto.password):
        raise BadRequestException('Your password is not strong, please choose stronger password')
    user.set_password_and_hash(register_dto.password)
    UserDbMethods.create_user(user)
    return

尝试直接return或return None时，Flask触发报错：

The view function for 'register_api.register' did not return a valid response. The function either returned None or ended without a return statement.

返回空字符串''能正常运行，但觉得不够直观，希望找到更语义化的实现方式。

解决方案 #

方案1：直接返回带204状态码的响应对象 #

使用Flask的make_response构造响应，明确指定状态码和空内容，代码语义化更强：

from flask import make_response

@register_bp.route('/auth/register', methods=['POST'])
def register():
    # 原有业务逻辑保持不变
    register_dto = RegisterDTO.from_dict(request.get_json())
    user: User = UsersConverter.convert_register_dto_to_entity(register_dto)
    if UserDbMethods.does_user_with_username_exist(user.username):
        raise DuplicatedException('This username is used, please choose other username')
    if UserDbMethods.does_user_with_email_exist(user.email):
        raise DuplicatedException('This email is used by another username.')
    if not AuthUtils.is_strong_password(register_dto.password):
        raise BadRequestException('Your password is not strong, please choose stronger password')
    user.set_password_and_hash(register_dto.password)
    UserDbMethods.create_user(user)
    
    # 返回204空响应
    return make_response('', 204)

方案2：自定义语义化辅助函数 #

如果多个接口需要返回204，可以封装一个辅助函数，让代码更易读：

from flask import make_response

def no_content():
    """返回204 No Content空响应"""
    return make_response('', 204)

@register_bp.route('/auth/register', methods=['POST'])
def register():
    # 原有业务逻辑不变
    # ...
    
    return no_content()

方案3：通过after_request钩子统一处理（可选） #

如果需要批量处理多个接口的204状态，可以先返回空响应，再在钩子中修改状态码，但这种方式不如直接在视图中指定直观：

@register_bp.route('/auth/register', methods=['POST'])
def register():
    # 原有业务逻辑不变
    # ...
    
    return ''  # 先返回空内容

@register_bp.after_request
def adjust_register_response(response):
    # 判断当前路由是否为注册接口，且原响应为200时修改为204
    if request.path == '/auth/register' and response.status_code == 200:
        response.status_code = 204
        response.data = b''  # 确保响应内容为空
    return response

关键说明 #

Flask要求视图函数必须返回有效的响应类型（响应对象、字符串、元组等），None是不被允许的，所以无法直接通过return None实现需求。上述方案中，方案1和方案2是最简洁直观的选择，能清晰表达返回204空响应的意图。

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