FastAPI部署至AWS Elastic Beanstalk时遇参数缺失错误

问题根源 #

日志中的TypeError: File() missing 1 required positional argument: 'default'是核心诱因，本质是本地与AWS Elastic Beanstalk环境的FastAPI版本不兼容：

• 本地使用的旧版FastAPI允许File()无参数直接调用（默认标记为必填项）
• 部署环境的新版FastAPI强制要求显式指定default参数（用...表示必填，或传入具体默认值）

解决方案 #

1. 修正File()调用语法 #

将File()改为File(...)，明确标记参数为必填项，适配新版FastAPI规则：

@app.post("/files")
async def create_file(file: bytes = File(...)):
    employeeCsv(file)
    return {"file_size": len(file)}

若需支持可选上传，可设置default=None：

@app.post("/files")
async def create_file(file: bytes = File(default=None)):
    if file:
        employeeCsv(file)
        return {"file_size": len(file)}
    return {"message": "未上传文件"}

2. 统一依赖版本 #

在项目根目录的requirements.txt中指定FastAPI具体版本，确保本地与部署环境依赖一致：

fastapi==0.100.0
uvicorn==0.23.2
# 其他项目依赖...

（版本号请替换为本地实际使用的版本）

3. 推荐使用UploadFile处理文件（可选） #

针对大体积CSV文件，UploadFile比bytes更高效，还能获取文件名等元数据，示例代码：

@app.post("/files")
async def create_file(file: UploadFile = File(...)):
    content = await file.read()
    employeeCsv(content)
    return {"file_name": file.filename, "file_size": len(content)}

部署验证 #

修改代码与requirements.txt后，重新打包部署至Elastic Beanstalk，查看日志确认服务启动正常，再测试网页文件上传功能。

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