Python接口返回乱码怎么解决？配置charset编码格式

Python后端接口返回中文乱码，绝大多数情况并非代码编码问题，而是响应头缺失关键的`charset=utf-8`声明——浏览器或客户端因此错误地按ISO-8859-1解析UTF-8字节流，导致“你好”变成“你好”。无论你用Flask（需手动拼接Content-Type或全局钩子补全）、Django（JsonResponse默认不带charset，必须显式传content_type参数），还是FastAPI（虽JSONResponse默认友好，但自定义响应如PlainTextResponse、StreamingResponse极易遗漏charset），都必须在响应头中完整写出`application/json; charset=utf-8`或`text/plain; charset=utf-8`；更隐蔽的是前端fetch/axios未设置responseType时，错误解析会被缓存，连刷新都无效，必须清缓存或重启标签页——掌握这一条底层原理，90%的接口乱码问题迎刃而解。

Python后端接口返回乱码，90% 是因为响应头没显式声明 charset=utf-8，浏览器或客户端按 ISO-8859-1 解析 UTF-8 字节流导致的。

Flask 中 response 的 charset 默认不生效

Flask 的 jsonify() 和 Response 默认不写 charset 到 Content-Type 头（即使你设了 response.charset = 'utf-8'），最终 header 仍是 application/json，不含 ; charset=utf-8。

• 正确做法：手动拼接 Content-Type，例如 return Response(data, content_type='application/json; charset=utf-8')
• 或用 make_response 后直接改 headers：resp.headers['Content-Type'] = 'application/json; charset=utf-8'
• 全局统一方案：在 after_request 钩子里补全，但注意别覆盖已有的 charset（比如文件下载接口）

Django 视图返回 JSON 时 Content-Type 缺少 charset

Django 的 JsonResponse 默认设置 Content-Type: application/json，但不带 charset 参数；虽然 Django 内部用 UTF-8 编码 body，但缺少声明会导致某些旧版 Android WebView 或 Java 客户端误判编码。

• 解决：显式传 content_type='application/json; charset=utf-8'，例如 return JsonResponse(data, content_type='application/json; charset=utf-8')
• 如果用 HttpResponse 手动序列化，务必加 content_type 参数，不能只依赖 json.dumps(..., ensure_ascii=False)
• 注意：Django 4.2+ 对 JsonResponse 的 charset 参数支持有限，仍需靠 content_type 字符串控制

FastAPI 的 JSONResponse 默认含 charset，但自定义响应容易漏

FastAPI 的 JSONResponse 默认 header 是 application/json; charset=utf-8，这点比 Flask/Django 更友好；但一旦你用 Response 包原始字符串、或返回 PlainTextResponse、或用 StreamingResponse，就完全不带 charset 声明。

• 返回中文字符串？别用 return "你好"，改用 return PlainTextResponse("你好", media_type="text/plain; charset=utf-8")
• 手动构造 JSON 字符串时，必须指定 media_type="application/json; charset=utf-8"，否则默认是 application/json
• 用 Response(content=..., media_type=...) 时，media_type 字符串要完整，不能只写 "application/json"

真正容易被忽略的是：前端 fetch 或 axios 没设 responseType、后端又没声明 charset，此时浏览器可能缓存错误的编码解析逻辑，连刷新都不管用——得清空响应缓存或强制关掉标签页重试。

到这里，我们也就讲完了《Python接口返回乱码怎么解决？配置charset编码格式》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！