FastAPI+Beanie开发Todo应用：创建Todo后Owner字段无法获取完整用户信息

核心原因 #

1. 创建Todo时未正确关联用户ID #

创建Todo实例时，如果owner字段没有被赋值为已存在的User实例或User的ObjectId，会导致Link字段仅保留集合名，id为None。比如代码中可能误传了空User对象，或是未从认证上下文获取当前用户的有效ID进行赋值。

2. Beanie默认延迟加载关联数据 #

Beanie的Link字段默认采用延迟加载策略：查询Todo时不会自动从关联的users集合拉取完整用户数据，仅返回Link的元信息（集合名和id）。如果id未正确设置，就会出现你看到的id: None, collection: "users"结果。

解决步骤 #

第一步：确保创建Todo时正确关联用户 #

从FastAPI的认证依赖中获取当前用户，将其直接赋值给Todo的owner字段：

from fastapi import Depends, HTTPException
from beanie import PydanticObjectId
from your_models import User, Todo, TodoCreate

# 示例：从认证中获取当前用户ID并查询用户实例
async def get_current_user(user_id: PydanticObjectId = Depends(get_current_user_id)):
    user = await User.get(user_id)
    if not user:
        raise HTTPException(status_code=404, detail="用户不存在")
    return user

@app.post("/todos/")
async def create_todo(todo: TodoCreate, current_user: User = Depends(get_current_user)):
    # 直接将当前用户实例赋值给owner字段
    new_todo = Todo(**todo.dict(), owner=current_user)
    await new_todo.save()
    return new_todo

如果只能获取到用户ID字符串，需先转换为PydanticObjectId再赋值：

new_todo = Todo(**todo.dict(), owner=PydanticObjectId(user_id_str))

第二步：查询时预加载关联的用户数据 #

要返回完整的用户信息，查询Todo时需调用fetch_link()（指定单个关联字段）或fetch_all_links()（加载所有关联字段）方法主动预加载：

@app.get("/todos/{todo_id}")
async def get_todo(todo_id: PydanticObjectId):
    # 预加载owner关联的User数据
    todo = await Todo.get(todo_id).fetch_link(Todo.owner)
    if not todo:
        raise HTTPException(status_code=404, detail="Todo不存在")
    return todo

第三步：检查模型定义正确性 #

确保User和Todo的Document模型中Link字段定义正确：

from beanie import Document, Link
from pydantic import Field

class User(Document):
    username: str
    email: str

    class Settings:
        collection = "users"

class Todo(Document):
    title: str
    description: str | None = None
    # 确保Link字段关联正确的User模型，且必填
    owner: Link[User] = Field(...)

    class Settings:
        collection = "todos"

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