Docker内运行Connexion/Flask返回base64图片报bytes不可JSON序列化如何解决

问题1 本地正常、Docker容器内报错的原因 #

这个问题和LANG环境变量没有关联，90%以上的概率是两类差异导致：

1. 依赖版本不一致：你本地环境的connexion、Flask等web框架依赖版本和Docker容器内的版本不同。部分旧版本的connexion存在自定义序列化逻辑的兼容问题，或者低版本Flask的JSON编码器对字符串类型的校验逻辑存在差异，就会出现本地高版本依赖自动兼容、容器内低版本报错的情况。
2. 代码执行路径/返回结构差异：你大概率只检查了cutout_b64这一个字段的类型，忽略了返回的整个JSON结构中还有其他字段是bytes类型；也有可能存在分支判断逻辑，容器内运行时触发的代码分支没有执行到decode("ascii")这一行，或者后续对解码后的字符串又做了encode操作转回了bytes类型。

你可以在返回响应前加一段调试代码确认所有字段类型，就能快速定位问题：

def traverse_check_type(obj, path="root"):
    if isinstance(obj, dict):
        for k, v in obj.items():
            traverse_check_type(v, path=f"{path}.{k}")
    elif isinstance(obj, list):
        for i, item in enumerate(obj):
            traverse_check_type(item, path=f"{path}[{i}]")
    elif isinstance(obj, bytes):
        print(f"发现bytes类型字段：{path}，值前100位为{str(obj[:100])}")

# 假设你的返回值是resp
traverse_check_type(resp)

问题2 正确解决方法 #

按优先级从高到低尝试：

1. 对齐依赖版本：在本地正常运行的环境执行pip freeze > requirements.txt，替换掉Docker构建时使用的依赖清单，保证本地和容器内所有依赖版本完全一致，排除版本兼容问题。
2. 补全所有bytes字段的转码逻辑：通过上面的调试代码找到所有bytes类型的字段，统一转成str类型。如果是base64编码的场景统一用decode("ascii")即可，普通字符串用decode("utf-8")。
3. 自定义JSON编码器兜底：如果确认所有字段都已转码还是报错，可以自定义Flask的JSON编码器，全局处理bytes类型的序列化：

from flask import Flask
from flask.json import JSONEncoder
import connexion

class BytesCompatibleJSONEncoder(JSONEncoder):
    def default(self, o):
        if isinstance(o, bytes):
            return o.decode("utf-8")
        return super().default(o)

# 如果你直接用Flask app
app = Flask(__name__)
app.json_encoder = BytesCompatibleJSONEncoder

# 如果你用connexion app
connexion_app = connexion.FlaskApp(__name__)
connexion_app.app.json_encoder = BytesCompatibleJSONEncoder

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