FastAPI启动抛出ModuleNotFoundError：找不到backend模块

解决ModuleNotFoundError: No module named 'backend'问题 #

问题根源 #

你的导入路径和Python运行时的模块搜索路径不匹配：当在backend目录下启动服务时，Python无法识别backend作为顶层模块，同时src目录也未被加入模块搜索路径，导致导入失败。

解决方案 #

1. 修正导入语句

main.py和schema.py都位于backend/src目录下，api是它们的同级子目录，需将绝对路径导入改为基于当前包的导入：

• 修改main.py：

from fastapi import FastAPI
from strawberry.fastapi import GraphQLRouter
# 替换原导入路径，直接从同级api包导入
from api.schema import schema

app = FastAPI()

graphql_router = GraphQLRouter(schema, path="/", graphql_ide="apollo-sandbox")

app.include_router(graphql_router)

• 修改schema.py：

import strawberry
# 替换原导入路径，直接从同级api包导入
from api.query import Query

schema = strawberry.Schema(query=Query)

2. 让Python识别src包

有两种可靠方式：

• 方式一：临时设置PYTHONPATH
  在backend目录下执行命令时，先将当前目录加入模块搜索路径：

# Linux/macOS
export PYTHONPATH=$(pwd) && uvicorn src.main:app --reload

# Windows PowerShell
$env:PYTHONPATH = Get-Location; uvicorn src.main:app --reload

• 方式二：从仓库根目录启动
  切换到Poker根目录，用完整模块路径启动服务，无需额外配置：

uvicorn backend.src.main:app --reload

3. 验证包结构

确保backend/src和backend/src/api目录下的__init__.py文件存在（你的目录结构已满足），空文件即可，这是Python识别包的必要条件。

为什么之前的修改无效？ #

你之前尝试改成api.schema但失败，核心原因是Python的模块搜索路径中没有包含backend目录，导致无法找到api子包。通过上述两种方式调整搜索路径后，导入逻辑就能正常工作。

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