当前位置：首页 > news >正文

Flask 解决 JSON 返回中文乱码问题方案

news 2025/7/9 5:19:56

在Flask开发中，API返回中文时默认会转换为Unicode转义序列。本文提供5种解决方案：全局配置：设置app.config[‘JSON_AS_ASCII’] = False，简单高效自定义JSON编码器：继承DefaultJSONProvider，扩展性强手动序列化：使用json.dumps(ensure_ascii=False)配合Response对象装饰器处理：批量处理多个接口的返回数据 Nginx配置：在生产环境通过服务器设置响应头所有方案核心都是通设置 ensure_ascii=False 禁用 Unicode 转义，让 JSON 数据以 UTF-8 编码格式输出，同时确保客户端能够正确解析 UTF-8 编码。

Flask 解决 JSON 返回中文乱码问题

在 Flask 开发中， API 返回结果里中文显示为 \u9ad8\u50cf 这类 Unicode 转义序列的情况？这是因为 JSON 序列化时，非 ASCII 字符默认会被转换成 Unicode 转义格式。别担心，只需简单配置就能让中文正常显示，以下是具体解决方案：

API 返回结果里中文显示

方案 1：全局配置（推荐）

通过设置 Flask 应用的全局配置，一次性解决所有接口的中文显示问题，这是最便捷的方式。

from flask import Flask, jsonifyapp = Flask(__name__)
# 关键配置：禁用 ASCII 转义，确保中文正常显示
app.config['JSON_AS_ASCII'] = False@app.route('/api/data')
def get_data():data = {"message": "高质量数据"}return jsonify(data)  # 直接返回包含中文的字典if __name__ == '__main__':app.run(debug=True)

配置后，API 返回的 JSON 数据中，中文会直接显示为 “高质量数据”，而不是 Unicode 转义序列。

方案 2：自定义 JSON 编码器（灵活扩展）

如果需要对 JSON 序列化过程进行更多自定义操作，可以通过继承默认的 JSON 提供器来实现。

from flask import Flask
from flask.json.provider import DefaultJSONProvider# 自定义 JSON 提供器，禁用 ASCII 转义
class CustomJSONProvider(DefaultJSONProvider):ensure_ascii = Falseapp = Flask(__name__)
# 应用自定义的 JSON 提供器
app.json = CustomJSONProvider(app)@app.route('/api/data')
def get_data():return {"message": "高质量数据"}  # 中文可正常显示

这种方式不仅能解决中文乱码问题，还能根据需求添加其他序列化逻辑，扩展性更强。

方案 3：手动序列化并返回响应（特殊场景适用）

在某些特殊场景下，你可能需要手动控制 JSON 序列化过程，这时可以使用 json.dumps() 方法，并配合 Response 构建响应。

from flask import Flask, Response
import jsonapp = Flask(__name__)@app.route('/api/data')
def get_data():data = {"message": "高质量数据"}# 手动序列化，设置 ensure_ascii=False 禁用转义，并指定内容类型return Response(response=json.dumps(data, ensure_ascii=False),content_type='application/json; charset=utf-8')

这种方式适合需要对响应进行更精细控制的场景，比如添加特定的响应头信息。

方案 4：使用装饰器（批量处理）

如果希望对多个接口统一处理中文显示问题，可以定义一个装饰器，自动处理函数返回的字典，将其转换为正确编码的 JSON 响应。

from flask import Response
import json
from flask import Flaskapp = Flask(__name__)# 定义装饰器，处理返回字典的接口，确保中文正常显示
def force_utf8_response(func):def wrapper(*args, **kwargs):result = func(*args, **kwargs)# 如果函数返回的是字典，则进行 JSON 序列化并设置正确的编码if isinstance(result, dict):return Response(response=json.dumps(result, ensure_ascii=False),content_type='application/json; charset=utf-8')return resultreturn wrapper@app.route('/api/data')
@force_utf8_response  # 应用装饰器
def get_data():return {"message": "高质量数据"}  # 中文可正常显示

通过装饰器，可以批量为多个接口添加中文显示处理逻辑，避免重复代码。

方案 5：修改 Nginx 配置（生产环境部署）

如果你的 Flask 应用通过 Nginx 反向代理部署，可以在 Nginx 配置中添加响应头，确保客户端以 UTF-8 编码解析 JSON 数据。

location /api/ {# 添加响应头，指定内容类型为 UTF-8 编码的 JSONadd_header Content-Type 'application/json; charset=utf-8';proxy_pass http://your_flask_app;  # 代理到 Flask 应用
}