使用BlackSheep+Piccolo ORM开发API遇Postman 400错误求助

常见问题点及解决步骤 #

1. 请求格式与Content-Type错误 #

这是最常见的触发原因：

• Postman发送请求时，未将Body设置为raw JSON格式，或未添加Content-Type: application/json请求头。
• 若使用form-data、x-www-form-urlencoded等格式，BlackSheep的FromJSON无法正确解析请求体，会导致模型字段全部为None，触发后续异常返回400。

解决方法：

• 在Postman的Body标签下选择raw，格式下拉框选JSON。
• 添加请求头Content-Type: application/json。
• 请求体使用与数据库字段一致的下划线命名，示例：

{
  "amount": 200,
  "description": "办公用品采购"
}

2. Pydantic模型定义不明确 #

代码中用typing.Any标注生成的模型，可能导致类型推断异常；同时create_pydantic_model默认未显式指定字段范围，容易出现匹配问题。

解决方法：
修正模型定义，指定正确的类型注解，并显式包含需要的字段：

from pydantic import BaseModel
from piccolo.utils.pydantic import create_pydantic_model

# 显式指定要包含的字段，确保模型与数据库表字段严格匹配
ExpenseModelIn: type[BaseModel] = create_pydantic_model(
    table=Expense,
    model_name="ExpenseModelIn",
    include_columns=[Expense.amount, Expense.description]
)

ExpenseModelOut: type[BaseModel] = create_pydantic_model(
    table=Expense,
    include_default_columns=True,
    model_name="ExpenseModelOut"
)

3. 异常处理过于宽泛 #

原代码使用裸except捕获所有异常，无法定位具体错误（比如Pydantic的字段验证错误、数据库保存失败），导致无法排查问题根源。

解决方法：
捕获具体异常并打印日志，方便调试：

from pydantic import ValidationError
import traceback

@app.router.post("/expense")
async def create_expense(expense_model: FromJSON[ExpenseModelIn]):
    print(expense_model.value)
    try:
        expense = Expense(**expense_model.value.dict())
        await expense.save()
        return ExpenseModelOut(**expense.to_dict())  
    except ValidationError as e:
        # 打印字段验证错误，快速定位格式问题
        print(f"字段验证失败: {e}")
        return Response(400, content=Content(b"text/plain", str(e).encode()))
    except Exception as e:
        # 捕获其他异常并打印堆栈信息
        print(f"服务器错误: {traceback.format_exc()}")
        return Response(500, content=Content(b"text/plain", b"服务器内部错误"))

4. 额外检查：BlackSheep中间件配置 #

如果自定义了全局中间件，检查是否有拦截或修改JSON请求体的逻辑，确保请求体能被正常传递到FromJSON解析器。

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