Flask类视图中HTML表单无法正常渲染的问题排查

问题出在Flask-RESTful的Resource类默认响应处理逻辑上：当你直接返回HTML字符串时，它会自动把响应的Content-Type设为text/plain，浏览器收到后会把内容当成纯文本渲染，而不是解析为HTML。普通Flask函数视图会自动识别HTML字符串并设置正确的text/html类型，所以之前能正常显示表单。

两种解决方法 #

方法1：用make_response包装HTML并指定Content-Type #

直接手动构建响应对象，设置正确的内容类型：

from flask import make_response
from flask_restful import Resource

class UploadResource(Resource):
    def get(self):
        form_html = '''
        <form method="POST" enctype="multipart/form-data">
            <input type="file" name="file" required>
            <button type="submit">上传文件</button>
        </form>
        '''
        # 创建响应对象并设置Content-Type
        resp = make_response(form_html)
        resp.headers['Content-Type'] = 'text/html'
        return resp

    def post(self):
        # 你的文件上传处理逻辑
        pass

方法2：使用模板渲染（更规范） #

如果表单内容复杂，推荐把HTML写在模板文件里，用render_template返回：

1. 在项目根目录创建templates文件夹，新建upload_form.html：

<form method="POST" enctype="multipart/form-data">
    <input type="file" name="file" required>
    <button type="submit">上传文件</button>
</form>

2. 修改类视图代码：

from flask import make_response, render_template
from flask_restful import Resource

class UploadResource(Resource):
    def get(self):
        # 用make_response包装模板渲染结果，确保Content-Type正确
        return make_response(render_template('upload_form.html'))

    def post(self):
        # 文件上传处理逻辑
        file = request.files.get('file')
        if file:
            # 保存文件等操作
            return {'message': '上传成功'}, 200
        return {'message': '未选择文件'}, 400

补充说明 #

Flask-RESTful设计初衷是构建RESTful API，返回JSON数据为主，所以对HTML响应的支持需要手动处理。如果你的场景需要同时提供HTML表单和API接口，上面的两种方法都能解决表单显示为文本的问题。

内容的提问来源于stack exchange，提问作者Mateusz