Python编写Flask API如何返回自定义JSON_使用jsonify格式化响应数据

云浩酱_3905

云浩酱_3905

2026-06-05

445人浏览

原创

直接用 json.dumps() 返回 json 会出错,因为 flask 默认响应体是字符串且未设置 content-type: application/json,导致前端解析失败或抛 typeerror;应使用 jsonify() 自动设置 headers、状态码和编码,但其仅支持基本类型,不支持自定义类或 datetime。

python编写flask api如何返回自定义json_使用jsonify格式化响应数据

为什么直接用 json.dumps() 返回 JSON 会出错

Flask 默认响应体是字符串,json.dumps() 虽然生成了 JSON 字符串,但没设置 Content-Type: application/json,前端可能解析失败,或 Flask 自带的调试器报 TypeError: The view function did not return a valid response。

常见错误现象:返回内容看着像 JSON(比如有花括号),但浏览器 Network 面板里 Response Headers 没有 Content-Type: application/json,fetch 的 .json() 报 Unexpected token。

  • 必须用 jsonify(),它自动设好 headers、状态码和编码
  • jsonify() 只接受 dict、list、str、int、float、bool、None,不支持自定义类或 datetime 对象(会抛 TypeError: Object of type X is not JSON serializable)
  • 传入单个非字典对象(如 jsonify([1,2,3]))是合法的,但 Flask 旧版本(app.config['JSONIFY_PRETTYPRINT_REGULAR'] = False

jsonify() 怎么处理嵌套数据和空值

它对 None、True、False、数字、字符串都原样转,但不会帮你过滤字段或扁平化结构。如果你传一个带 datetime 的 dict,会直接崩。

使用场景:API 返回用户信息时,数据库查出的 ORM 对象常含 created_at(datetime 类型)、is_active(bool)、profile(嵌套 dict)——这些不能直接喂给 jsonify()。

Li Python Sec Check
Li Python Sec Check

Python 安全规范检查工具:基于 CloudBase 规范、腾讯安全指南,LLM 智能分析(默认禁用,优先本地执行)

下载
  • 先手动转换:用 isoformat() 处理 datetime,例如 "created_at": user.created_at.isoformat()
  • 避免传整个 ORM 实例,只构造所需字段的 dict,比如 {"id": u.id, "name": u.name, "joined": u.joined_at.isoformat()}
  • jsonify() 对 None 值保留为 null,符合 JSON 规范,无需额外处理

如何返回带状态码和自定义 headers 的 JSON 响应

jsonify() 本身不支持直接设 status 或 headers,但可以链式调用 .status_code 和 .headers.set() —— 这是 Flask 的响应对象机制决定的。

性能影响:每次调用 jsonify() 都新建一个 Response 实例,但开销极小,不用优化;重点是别在循环里反复 jsonify 同一份数据。

  • 改状态码:return jsonify({"error": "not found"}).status_code = 404(注意:赋值写法在老版本 Flask 中不生效,推荐用元组形式)
  • 更稳妥写法:return jsonify({"msg": "ok"}), 201(元组第二项是 status code)
  • 加 headers:resp = jsonify({"data": [...]}) → resp.headers["X-Api-Version"] = "v2" → return resp
  • 不要用 make_response(jsonify(...)) 套两层,冗余且易出错

遇到中文乱码或特殊字符怎么处理

默认情况下,jsonify() 会把中文转成 Unicode 转义(如 "\u4f60\u597d"),不是 bug,是 JSON 标准行为。但有些前端(尤其老版 iOS WebView)解析不稳。

兼容性影响:Python 3.8+ + Flask 2.0+ 默认禁用 ASCII 转义,中文直出;若你看到 \uXXXX,大概率是 Flask 版本低或显式设置了 app.config['JSON_AS_ASCII'] = True。

  • 强制中文不转义:app.config['JSON_AS_ASCII'] = False(推荐放在 app 初始化后)
  • 如果用了 jsonify() 还是乱码,检查是否在 response 后又手动调了 .encode('utf-8') —— jsonify() 已返回 UTF-8 编码的 bytes,重复 encode 会破坏
  • 路径参数或 query string 里的中文不影响 jsonify(),那是 request 解析阶段的事
事情说清了就结束。最常被忽略的是 datetime 和 list 的序列化限制,还有误以为 jsonify() 能接任意 Python 对象——它只认基础类型,别的得自己剥一层。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python flask api开发 js json

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1691

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4264

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1689

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

24857

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3027

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3067

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1163

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2363

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程