如何解决Python中的循环导入错误？Strawberry GraphQL场景示例

你遇到的是典型的Python循环导入问题——User和Post模块互相引用对方的类，导致模块初始化时出现错误。下面是几个靠谱的解决办法：

方法1：使用字符串类型注解（最简单） #

Python 3.7及以上支持用字符串代替直接引用类，解释器解析代码时不会立即尝试导入依赖类，而是延迟到类型检查阶段，完美避开循环导入。

修改User.py：

from .Comment import *
from typing import List
import strawberry
from datetime import datetime

@strawberry.type
class User:
    id: str
    email: str
    username: str | None
    posts: List["Post"]  # 用字符串代替直接导入的Post
    comments: List[Comment]
    createdAt: datetime
    updatedAt: datetime

修改Post.py：

import strawberry
from datetime import datetime

@strawberry.type
class Post:
    _id: str
    userId: str
    user: "User" | None  # 用字符串代替直接导入的User
    content: str
    createdAt: datetime
    updatedAt: datetime

如果是Python 3.9及以下版本，记得在文件顶部加上from __future__ import annotations来启用字符串类型注解支持。

方法2：使用Strawberry专门的LazyType（贴合GraphQL场景） #

Strawberry提供了LazyType工具，专门处理GraphQL类型间的循环依赖：

修改User.py：

from .Comment import *
from typing import List
import strawberry
from datetime import datetime

@strawberry.type
class User:
    id: str
    email: str
    username: str | None
    posts: List[strawberry.LazyType["Post", "GraphQl.models.Post"]]
    comments: List[Comment]
    createdAt: datetime
    updatedAt: datetime

修改Post.py：

import strawberry
from datetime import datetime

@strawberry.type
class Post:
    _id: str
    userId: str
    user: strawberry.LazyType["User", "GraphQl.models.User"] | None
    content: str
    createdAt: datetime
    updatedAt: datetime

注意"GraphQl.models.Post"是Post类的完整模块路径，需要根据你的项目实际结构调整。

方法3：延迟导入（备选） #

把导入语句移到类定义之后，避开初始化阶段的循环引用：

修改User.py：

from .Comment import *
from typing import List
import strawberry
from datetime import datetime

@strawberry.type
class User:
    id: str
    email: str
    username: str | None
    posts: List["Post"]
    comments: List[Comment]
    createdAt: datetime
    updatedAt: datetime

# 类定义完成后再导入依赖
from .Post import Post

修改Post.py：

import strawberry
from datetime import datetime

@strawberry.type
class Post:
    _id: str
    userId: str
    user: "User" | None
    content: str
    createdAt: datetime
    updatedAt: datetime

# 类定义完成后再导入依赖
from .User import User

优先推荐方法1或方法2，更符合Python类型注解和Strawberry的最佳实践。

内容的提问来源于stack exchange，提问作者Ăżiž