Flask设置返回json格式数据

最新推荐文章于 2025-03-17 18:03:20 发布

james_laughing

最新推荐文章于 2025-03-17 18:03:20 发布

阅读量665

点赞数

分类专栏： python flask

flask 同时被 2 个专栏收录

48 篇文章

订阅专栏

python

36 篇文章

订阅专栏

本文介绍如何在Flask应用中正确返回JSON格式的数据，包括使用jsonify模块、自定义Response类及force_type方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

https://blog.youkuaiyun.com/angus_17/article/details/80455838

from flask import Flask, jsonify
 
app = Flask(__name__)
 
 
@app.route('/')
def root():
    t = {
        'a': 1,
        'b': 2,
        'c': [3, 4, 5]
    }
    return jsonify(t)
 
if __name__ == '__main__':
    app.debug = True
    app.run()

问题描述

在Flask中直接返回list或dict是不行的，如

Python

from flask import Flask
app = Flask(__name__)
@app.route('/')
def root():
t = {
'a': 1,
'b': 2,
'c': [3, 4, 5]
}
return t
if __name__ == '__main__':
app.debug = True
app.run()

这样访问会直接提示

<code class="language-plain" style="font-family:Consolas, Monaco, 'Andale Mono', 'Ubuntu Mono', monospace;font-size:13.6px;background:transparent;margin:0px;word-spacing:normal;line-height:inherit;border:0px;">TypeError: 'dict' object is not callable<span class="line-numbers-rows" style="font-size:13.6px;width:3em;letter-spacing:-1px;border-right:1px solid rgb(153,153,153);"><span></span></span></code>

其原因是Flask并不会将list或dict默认转换为json格式。

解决方法

HTTP返回json格式数据主要有两个方面：

数据本身为json格式；
Content-Type声明为json格式。

使用标准库`json`

比较常见的是采用标准库json进行格式转换：

Python

from flask import Flask
import json
app = Flask(__name__)
@app.route('/')
def root():
t = {
'a': 1,
'b': 2,
'c': [3, 4, 5]
}
return json.dumps(t)
if __name__ == '__main__':
app.debug = True
app.run()

这样当访问时即能够正常得到json数据。但这么做有一个缺点，就是HTTP返回的Content-Type仍然是text/html，即HTTP认为内容是HTML。

声明`Content-Type`为json格式

在上面的解决方法上作一个加强，手动指定其Content-Type为application/json，通常采用的是修改Flask中的Response模块：

Python

from flask import Flask, Response
import json
app = Flask(__name__)
@app.route('/')
def root():
t = {
'a': 1,
'b': 2,
'c': [3, 4, 5]
}
return Response(json.dumps(t), mimetype='application/json')
if __name__ == '__main__':
app.debug = True
app.run()

这样不仅HTTP返回的内容是json，而且返回的Content-Type也是application/json了。

使用Flask的`jsonify`模块

实际上flask已经为json准备了专门的模块：jsonify。jsonify不仅会将内容转换为json，而且也会修改Content-Type为application/json。

Python

from flask import Flask, jsonify
app = Flask(__name__)
@app.route('/')
def root():
t = {
'a': 1,
'b': 2,
'c': [3, 4, 5]
}
return jsonify(t)
if __name__ == '__main__':
app.debug = True
app.run()

自定义Flask的`Response`，使用`force_type()`（2017.11.9更新）

对于某些特殊的情况，可能并不想每个返回json数据的方法都使用jsonify()包起来，那有没有什么“非侵入式”的方法实现jsonify()的功能呢？其实是有的，不过这个方法相对比较高端。

Flask返回的内容实际是Response对象，return语句的内容实际是交给Response处理后才输出由HTTP返回的；也就是说，之前直接返回dict报错TypeError: 'dict' object is not callable也是Response干的。那么只需要在Response处理如dict等“非法”数据是，告诉Response该怎么做就好了，这里就是用到了其force_type()方法了，所有不能处理的数据，都由force_type()方法尝试处理后，再决定报错或通过。直接看例子吧。