PyInstaller打包FastAPI后路由无法识别，触发循环导入错误

架构老林

2026-6-22

FastAPI + PyInstaller打包后循环导入导致路由无法识别的解决方法

问题根源

从报错栈可明确循环导入链：
main.py → checkprices_routes.py → search_repository.py → product_classes_DAO.py → main.py
模块初始化过程中形成闭环，导致checkprices_routes模块未完全加载，因此找不到check_prices_router属性。本地运行正常是因为Python模块缓存机制弱化了循环导入的影响，但打包后运行环境的模块加载逻辑放大了这个问题。

解决步骤

1. 拆分全局依赖，切断循环链

将main.py中的全局对象（如LOGGER）迁移到独立模块，避免其他模块直接导入main.py：

新建core/logging_config.py，在其中定义LOGGER：

import logging

LOGGER = logging.getLogger(__name__)
# 此处添加你的日志配置逻辑

修改product_classes_DAO.py的导入语句：

# 替换原语句 from main import LOGGER
from core.logging_config import LOGGER

修改main.py，同样从独立模块导入LOGGER：
```
from core.logging_config import LOGGER
```

2. 优化路由导入方式

替换动态导入为直接导入，减少初始化顺序问题：

# 替换原importlib动态导入代码
from v1.routes.checkprices_routes import check_prices_router
from v1.routes.commons_routes import commons_router

# 直接包含路由
app.include_router(check_prices_router, prefix=rprefix)
app.include_router(commons_router, prefix=rprefix)

3. 配置PyInstaller打包参数（推荐）

生成并修改spec文件，确保所有依赖模块被正确打包：

生成spec文件：
```
pyi-makespec main.py
```

打开生成的main.spec，在hiddenimports中添加所有需要的子模块：

hiddenimports=[
    'v1.routes.checkprices_routes',
    'v1.routes.commons_routes',
    'v1.repositories.checkprices_search.search_repository',
    'v1.models.dao.product_classes_DAO'
]