如何在Python Connexion控制器中正确返回内联文件内容

你碰到的这个错误原因很明确：Connexion默认会把返回的字节流当作UTF-8文本去解码，但图片是二进制数据，根本不是UTF-8编码的，自然会抛出解码失败的错误。

要正确返回内联图片，你需要明确告诉Connexion这是二进制的图片数据，同时指定正确的Content-Type头部，避免它做不必要的文本解码。直接返回包含二进制内容、HTTP状态码、响应头的三元组即可，具体代码可以这么改：

import mimetypes

def file_contents_get(file_id):
    file = app.datastore.get_instance().get_file(file_id)
    
    # 自动识别文件的MIME类型（比如image/png、image/jpeg）
    mime_type, _ = mimetypes.guess_type(file.path)
    # 兜底处理，如果识别不出来就用通用二进制类型
    mime_type = mime_type or "application/octet-stream"
    
    with open(file.path, "rb") as f:
        # 返回三元组：二进制内容、HTTP状态码、响应头
        return f.read(), 200, {
            "Content-Type": mime_type,
            # 若需要明确强制内联展示，可添加此行（通常浏览器会自动识别处理）
            # "Content-Disposition": "inline"
        }

这么做的核心逻辑是：当你返回这个三元组时，Connexion会直接把二进制内容作为响应体发送给客户端，同时通过Content-Type告诉浏览器这是一张图片，浏览器就会以内联形式展示它，而不会尝试把它当成文本解码。

如果你已经在OpenAPI规范里给这个接口定义了produces字段（比如produces: ["image/png", "image/jpeg"]），也能辅助Connexion正确处理响应，但手动在代码里设置Content-Type会更稳妥。

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