向Python FastAPI接口端点传图片时base64字符破坏URL如何解决？

现有方案快速修复 #

你遇到的报错是因为标准base64字符包含/、+、=三类URL特殊字符，放入路径参数时会被URL解析器误判为路径分隔符或者参数标识，有两种临时修复方式：

• 改用URL安全的base64编解码：发送端使用base64.urlsafe_b64encode生成字符串，会自动把/替换为_、+替换为-，删除末尾填充的=，服务端接收后用base64.urlsafe_b64decode反向解析即可，不需要手动处理字符。
• 给路径参数增加路径匹配标识：将路由规则修改为@app.get("/get_predictions/{base64_str:path}")，:path通配符会让FastAPI把后面所有路径内容都识别为base64_str参数的值，不会按/做路径分段。
  注意：以上两种修复方案都存在本质缺陷，大部分Web服务器对URL总长度限制在2KB~8KB区间，稍大的图片转成base64后长度会直接超出限制，导致请求被截断失败。

更合理的实现思路 #

直接放弃GET+路径参数的传输方式，改用POST请求传输图片，是业界通用的图片类接口实现方案，有两种可选的成熟方案：

方案1：POST直接上传二进制文件（最推荐） #

不需要做base64编解码，省流量且处理逻辑更简单，FastAPI原生支持文件上传，代码示例：

from fastapi import FastAPI, File, UploadFile

app = FastAPI()

@app.post("/get_predictions")
def get_predictions(file: UploadFile = File(...)):
    # 直接读取二进制图片内容传给处理函数即可
    img_bytes = file.file.read()
    return get_model_predictions(img_bytes)

客户端以multipart/form-data格式上传图片文件即可，相比base64传输性能提升30%左右，也没有内容长度限制。

方案2：POST Body传base64字符串 #

如果业务场景必须使用base64格式传输，可以把base64字符串放在POST请求的JSON报文中，完全规避URL解析问题，代码示例：

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class ImageRequest(BaseModel):
    base64_str: str

@app.post("/get_predictions")
def get_predictions(req: ImageRequest):
    return get_model_predictions(req.base64_str)

客户端将base64字符串放入JSON的base64_str字段中发起POST请求即可。

内容的提问来源于stack exchange，提问作者F.Hand