Flask响应的艺术：自定义状态码、响应头与多格式数据返回（JSON/文件流）
更多内容请见： 《Python Web项目集锦》 - 专栏介绍和目录
文章目录
- 第一章：破除迷思——Flask视图函数的“多面体”本质
- 第二章：精准表达——HTTP状态码的艺术运用
- 2.1 元组语法：最简洁的控制方式
- 2.2 make_response：获取响应对象的控制权
- 2.3 RESTful API 状态码使用指南（最佳实践）
- 第三章：定制规则——玩转响应头
- 3.1 通过元组添加头部
- 3.2 通过 Response 对象添加头部
- 3.3 响应头的“坑”：大小写与重复
- 第四章：前后端分离的基石——优雅返回JSON
- 4.1 为什么必须用 `jsonify`？
- 4.2 解决中文乱码的终极方案
- 4.3 工业级标准：统一JSON响应结构
- 第五章：二进制与流式响应——突破内存限制的魔法
- 5.1 简单的二进制文件返回
- 5.2 `send_file`：Flask官方的文件发送利器（推荐）
- 5.3 流式响应：处理GB级大数据的终极方案
- 5.4 Server-Sent Events (SSE)：实现服务器主动推送
- 第六章：面向未来的架构——错误处理与全局响应拦截
- 6.1 全局异常处理器：统一错误响应格式
- 6.2 `@after_request`：全局响应后置钩子（神器）
- 6.3 处理预检请求
Web应用的本质是“请求-响应”的循环。如果说处理请求是“内功”，那么构建响应就是“外功”——它直接决定了用户体验、API的规范性、SEO的效果以及系统的鲁棒性。
很多初学者构建响应的方式极其单一：返回一个字符串，或者草草jsonify一下。但在真实的工业级项目中，响应是一项精密的工程：你需要精确控制HTTP状态码来符合RESTful规范，需要定制响应头来解决跨域和缓存问题，更需要灵活地在JSON、HTML、文件流、二进制数据之间无缝切换。
第一章：破除迷思——Flask视图函数的“多面体”本质
在Flask中，当你写下return "Hello"时，Flask到底做了什么？理解这一点，是掌握响应艺术的基石。
核心真相：Flask的视图函数不仅可以返回字符串，它可以返回任何东西。
当你的视图函数返回一个非字符串、非元组、非Response对象的数据时，Flask会将其抛给app.response_class（默认是Response类）进行处理。具体转换逻辑如下：
- 字符串：被当作响应体，状态码默认为
200，Content-Type默认为text/html; charset=utf-8。 - 字典：在Flask 1.1.0及以上