在 flask 中使用类视图（如 flask-restful 的 `resource`）时，若 `get()` 方法直接返回 html 字符串，浏览器会将其作为纯文本显示而非渲染为网页——根本原因是响应缺少正确的 `content-type: text/html` 响应头。
当你将原本基于函数的路由（@app.route）迁移到类视图（例如 flask_restful.Resource）时，一个关键差异被忽略了：类视图默认以 API 方式处理响应，返回的是 JSON 或纯文本格式，不会自动设置 HTML 渲染所需的响应头。
在原始函数视图中，Flask 会根据返回值类型（字符串）自动推断并设置 Content-Type: text/html（尤其在开发模式或简单字符串返回时行为较宽松）。但 flask_restful.Resource 的 get() 方法默认将返回值序列化为 JSON，并强制设置 Content-Type: application/json —— 即使你返回的是 HTML 字符串，浏览器也会将其当作纯文本下载或显示，而非解析渲染。
✅ 正确做法：显式构造 Response 对象，并指定 content_type="text/html"：
from flask import Response
from flask_restful import Resource
class Form(Resource):
def get(self):
html = '''
<!doctype html>
<title>Upload new File</title>
<h1>Upload new File</h1>
<form method="post" enctype="multipart/form-data">
<input type="file" name="file">
<input type="submit" value="Upload">
</form>
'''
return Response(html, content_type="text/html")
def post(self):
file = request.files.get('file')
if file and file.filename: # 注意：检查 filename 避免空上传
# ✅ 实际处理逻辑（如保存、解析等）
# file.save(f'/path/to/save/{file.filename}')
return {'status': 'success', 'filename': file.filename}, 200
return {'error': 'No file provided'}, 400⚠️ 注意事项：
-
flask_restful.Resource 本质是为构建 RESTful API 设计的，不推荐用于渲染 HTML 页面；若需服务 HTML 表单，优先使用 Flask 原生的 MethodView（更轻量、专为 Web 页面设计）：
from flask.views import MethodView class FormView(MethodView): def get(self): return ''' <!doctype html> <title>Upload File</title> <h1>Upload new File</h1> <form method="post" enctype="multipart/form-data"> <input type="file" name="file"> <input type="submit" value="Upload"> </form> ''' def post(self): file = request.files.get('file') if file and file.filename: return f"Received: {file.filename}" return "No file uploaded", 400 app.add_url_rule('/send', view_func=FormView.as_view('form')) -
表单 method="post" 必须与后端接收路径的 HTTP 方法一致；确保前端
安全提示：生产环境中切勿内联 HTML，应使用 render_template() 加载 Jinja2 模板，并启用 CSRF 保护。
总结：类视图返回 HTML 失效的核心在于响应头缺失，解决方式不是修改表单，而是显式控制响应类型——用 Response(html, content_type="text/html") 替代裸字符串返回。但更优架构是按职责分离：API 用 Resource，页面渲染用 MethodView 或函数视图。
