FastAPI文件上传功能在Deta云平台无法正常运行

排查步骤及解决方案 #

1. 捕获异常，暴露具体错误 #

Deta生产环境默认不会返回详细错误栈，先修改POST接口添加异常捕获，这是定位问题的核心：

from fastapi import HTTPException

@app.post("/processfile/")
async def process_file(file: UploadFile) -> FileResponse:
    try:
        path = file.filename
        if os.getenv("DETA_RUNTIME") == "true":
            path = Path("/tmp") / file.filename
        pdf_content = await file.read()
        processed_pdf = pdfpad(pdf_content)
        saved_path = save_pdf(processed_pdf, path)
        # 校验文件是否生成成功
        if not Path(saved_path).exists():
            raise HTTPException(status_code=500, detail="处理后的PDF文件未生成")
        return FileResponse(saved_path)
    except Exception as e:
        raise HTTPException(status_code=500, detail=str(e))

部署后重新测试POST请求，就能看到具体错误（比如依赖缺失、文件写入失败等）。

2. 确认依赖全量安装 #

Deta会根据项目根目录的requirements.txt安装依赖，确保pdfpad及其所有依赖都在文件中。可以本地执行pip freeze > requirements.txt生成依赖列表，再清理掉无关包，示例：

fastapi>=0.100.0
uvicorn>=0.23.2
pdfpad>=x.x.x
# 补充pdfpad依赖的其他库，例如PyPDF2、reportlab等（根据实际依赖添加）

3. 验证/tmp目录的文件操作逻辑 #

Deta的/tmp目录可读写，但要确保：

• save_pdf函数用二进制写入模式保存文件，示例：

def save_pdf(pdf_bytes, path):
    with open(path, "wb") as f:
        f.write(pdf_bytes)
    return str(path)  # 返回字符串路径，避免Path对象兼容性问题

• 若处理大文件，可改为分块读取上传内容，避免内存溢出。

4. 检查pdfpad的处理逻辑 #

如果pdfpad是自定义或第三方库，确认：

• 它能正确处理上传的PDF二进制数据，本地用相同测试文件验证逻辑一致性
• 若pdfpad依赖系统级库（如poppler），Deta环境可能未预装，需更换为纯Python实现的PDF处理库。

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