Python Flaskからタプルをreturnしたいのですがどのようにすればよいでしょうか？

Question

前提

PythonのFlaskでバックエンドAPIをつくっています（WEBアプリのフロントにHTMLを返すものではなく、別のバックエンドにデータを返すためのAPIです）。

実現したいこと

FlaskのAPIからタプルを返却したい(タプル型自体がFlaskの処理結果として返却できることはわかっているのですが、どのように記述すれば可能なのかがわかりません）。

発生している問題・エラーメッセージ

タプルをステータスコードとHTTPヘッダー部分を含めて返却させるコートを書いたものの、以下のエラーが出てしまいました

TypeError: The view function did not return a valid response. The return type must be a string, dict, list, tuple with headers or status, Response instance, or WSGI callable, but it was a tuple.

該当のソースコード

#デコレーターの記述を省略しています
def main(request):
    resp = "this is a test"
    status_code = "200"
    headers = {"header1": "one", "header2": "two", "header3": "three"}
    return (resp, status_code, headers)

試したこと

最初はステータスコードとヘッダーを省略していましたが、ステータスコードかヘッダーのいずれかか両方を含めてくださいというエラーがでたので、記述しました。しかし、上記のエラーになってしまいました。

補足情報（FW/ツールのバージョンなど）

Google Cloud function上でのデプロイになります（Google Cloud functionのpythonランタイム自体がFlask）

Comments

[TakaiY]

前の質問と同様、WebAPIでpythonのオブジェクトを直接返すことはできないはずですが「タプル型自体がFlaskの処理結果として返却できる」とはどういう意味でしょうか？

また、タプルを返そうとして、質問にあるエラーが出たときのコードも提示していただけますか。

[quickquip]

https://teratail.com/help/question-tips#questionTips34
> 実際に起きた結果を示しましょう。例えば、「○○というエラーが表示された」、「レイアウトがこのように崩れてしまった」等です。あなたの想像ではなく、実際に起きたことを述べましょう。
> 実際に起きたことと、あなたの予想をはっきり分けて書きましょう。

> 表示されたエラーメッセージをそのままコピー&ペーストしましょう。自分でタイプしなおしたり、自分で解釈・要約しようとしてはいけません。
> 大事な部分が抜け落ちたり情報が違うものになってしまう可能性があるからです。

Answer 1

質問のコードだと再現しませんが、エラーから逆算すると resp に入っているものがタプルになっていると思います。

例えば質問のコードの該当部分末尾に,を入れて

    resp = "this is a test",

とすると同じメッセージ(TypeError: The view function did not return a valid response. The return type must be a string, dict, tuple, Response instance, or WSGI callable, but it was a tuple.)のエラーが再現します。

---

https://github.com/pallets/flask/blob/2.2.2/src/flask/app.py
エラーが出ているのはここです。
その上で、渡されたものが3値のタプルだったらここでタプルの1番目の要素がrvに再代入されてます。
その再代入されたrvがタプルだと2141行から始まるif文のチェックに引っかからず、ここで返された3値タプルの1つ目の型がタプルだと判明します。
The view function did not return a valid response. The return type must be a string, dict, list, tuple with headers or status, Response instance, or WSGI callable, but it was a tuple. になりますから。

そのように仮定すると、

ステータスコードかヘッダーのいずれかか両方を含めてくださいというエラーがでたので、

とつじつまが合います。ここが真で、ここに突入したはずで、この
The tuple must have the form (body, status, headers), (body, status), or (body, headers).
のエラーのことを言っているんだろうと推測されるからです。

Comments

[teratera_f1]

ありがとうございます。こちらにhttps://blowup-bbs.com/python-flask_response/
-----------------
view関数からの戻り値の対応パターンは次の5つになります。
Responseオブジェクトの場合
str型データを返す場合
dict型データを返す場合
tuple型データを返す場合
それ以外の場合
---------------
とあったので tupleが戻せるんだなと思ったのですが、よくよく理解しますと、
あくまで、tupleを使って(返せる要素（上記のtuple以外）,ステータスコード,ヘッダー)という形にして返せますということであって、自分が返したいデータを複数詰め込んだtupleを返せるわけではなかったのですね。
少々混乱しておりました。　どうもありがとうございました。