Flask中返回JSON数据首选jsonify函数，它自动设置Content-Type并转换Python对象为JSON格式；支持字典、列表等可序列化类型，建议始终返回字典结构以避免字符串被转为数组；可通过返回元组或使用make_response设置自定义状态码；处理如datetime等非序列化对象时需自定义JSONEncoder；也可用Response对象手动控制响应，但需自行序列化数据。
直接来说，在 Flask 中返回 JSON 数据非常简单，主要依赖
jsonify函数。它能自动设置正确的
Content-Type头部，并且处理 Python 对象到 JSON 格式的转换。
解决方案
最基础的用法是导入
jsonify，然后将你的数据（字典、列表等）作为参数传递给它，最后从 Flask 路由函数中返回。例如：
from flask import Flask, jsonify
app = Flask(__name__)
@app.route('/api/data')
def get_data():
data = {'message': 'Hello from Flask!', 'status': 'success'}
return jsonify(data)
if __name__ == '__main__':
app.run(debug=True)这段代码创建了一个简单的 API 端点
/api/data，当你访问这个端点时，你会得到一个包含
message和
status的 JSON 响应。
立即学习“Python免费学习笔记（深入）”；
Flask 如何处理非字典类型的 JSON 数据？
jsonify不仅能处理字典，还能处理列表和其他可序列化为 JSON 的 Python 对象。但如果你直接传递一个字符串给
jsonify，Flask 会自动将其包装成一个 JSON 数组。为了避免这种行为，最好总是返回一个字典，即使你只想返回一个简单的值。例如：
from flask import Flask, jsonify
app = Flask(__name__)
@app.route('/api/message')
def get_message():
message = "This is a simple message."
return jsonify({'message': message}) # 始终返回一个字典
if __name__ == '__main__':
app.run(debug=True)如何自定义 JSON 响应的状态码？
默认情况下，
jsonify返回的状态码是 200 OK。但你可能需要根据不同的情况返回不同的状态码，例如 400 Bad Request 或 500 Internal Server Error。你可以通过在
jsonify函数调用后链式调用
make_response方法来实现。
from flask import Flask, jsonify, make_response
app = Flask(__name__)
@app.route('/api/error')
def handle_error():
error_data = {'error': 'Something went wrong!'}
response = jsonify(error_data)
response.status_code = 500 # 设置状态码为 500
return response
if __name__ == '__main__':
app.run(debug=True)更简洁的方式是直接返回一个元组，其中第一个元素是 JSON 数据，第二个元素是状态码：
from flask import Flask, jsonify
app = Flask(__name__)
@app.route('/api/error_simple')
def handle_error_simple():
error_data = {'error': 'Another error occurred!'}
return jsonify(error_data), 400 # 直接返回数据和状态码
if __name__ == '__main__':
app.run(debug=True)如何处理 JSON 序列化错误？
有时候，你的数据可能包含无法直接序列化为 JSON 的对象，例如 datetime 对象。在这种情况下，你需要自定义 JSON 编码器。Flask 允许你通过继承
json.JSONEncoder类并重写
default方法来实现这一点。
import json
from datetime import datetime
from flask import Flask, jsonify
class CustomJSONEncoder(json.JSONEncoder):
def default(self, obj):
if isinstance(obj, datetime):
return obj.isoformat() # 将 datetime 对象转换为 ISO 8601 字符串
return super().default(obj)
app = Flask(__name__)
app.json_encoder = CustomJSONEncoder # 设置自定义 JSON 编码器
@app.route('/api/date')
def get_date():
date_data = {'current_time': datetime.now()}
return jsonify(date_data)
if __name__ == '__main__':
app.run(debug=True)这段代码定义了一个
CustomJSONEncoder类，它会将
datetime对象转换为 ISO 8601 格式的字符串。然后，我们将这个自定义编码器赋值给
app.json_encoder，Flask 就会使用它来序列化 JSON 数据。
如何在 Flask 中使用
Response对象返回 JSON？
虽然
jsonify很方便，但有时你可能需要更细粒度的控制。这时，你可以直接使用 Flask 的
Response对象。你需要手动将数据序列化为 JSON 字符串，并设置
Content-Type头部。
import json
from flask import Flask, Response
app = Flask(__name__)
@app.route('/api/custom')
def get_custom_response():
data = {'message': 'Custom response!'}
json_data = json.dumps(data) # 手动序列化为 JSON 字符串
return Response(json_data, mimetype='application/json') # 创建 Response 对象
if __name__ == '__main__':
app.run(debug=True)使用
Response对象的好处是可以完全控制响应的各个方面，例如头部、状态码和内容类型。但是，你也需要自己处理 JSON 序列化，这可能会增加一些复杂性。
总的来说，
jsonify是 Flask 中返回 JSON 数据的首选方式，因为它简单易用，并且能自动处理许多细节。但是，在需要更高级的控制时，
Response对象也是一个强大的选择。
