FastAPI如何正确注册独立文件中的Tortoise signals信号

你的信号不触发核心是两个问题：

1. 信号模块导入路径错误：signals.py存放在core包目录下，你写的裸import signals会让Python从系统路径根目录查找signals模块，要么直接导包失败，要么因为运行目录问题加载到错误路径的重复模块，导致信号根本没注册到Tortoise实际使用的模型类上。
2. 导入路径不统一导致类不匹配：如果你的运行工作目录是core文件夹，会出现import models和import core.models加载出两个不同的UserModel类对象，你把信号绑定到了前者，而Tortoise初始化用的是后者，自然不会触发信号。

1. 修正导入路径，统一导入规则 #

所有导入都统一从项目根包core开始写绝对导入，包内文件可以用相对导入，绝对不要写裸的import signals/import models这种跨目录的顶层导入。
根据你create_app所在位置选对应写法：

情况1：create_app写在根目录main.py（和项目结构匹配的推荐写法） #

把原来的错误导入替换成从core包开始的绝对导入，确保在注册Tortoise之前加载信号模块：

# 根目录 main.py
from fastapi import FastAPI
from tortoise.contrib.fastapi import register_tortoise
from fastapi.staticfiles import StaticFiles

# 统一用根路径绝对导入
from core.router import router
# 正确导入core包下的signals，触发装饰器注册信号
from core import signals

def create_app():
    app = FastAPI()
    app.mount("/static", StaticFiles(directory="static"), name="static")

    register_tortoise(
        app=app,
        db_url="postgres://postgres:1234@localhost:5432/ecommerce_db",
        modules={"models": ["core.models"]},
        generate_schemas=True,
        add_exception_handlers=True,
    )
    app.include_router(router)
    return app

app = create_app()

情况2：create_app写在core/__init__.py（包内工厂函数） #

用相对导入加载同目录下的signals：

# core/__init__.py
from fastapi import FastAPI
from tortoise.contrib.fastapi import register_tortoise
from fastapi.staticfiles import StaticFiles

from .router import router
# 相对导入同目录的signals模块
from . import signals

def create_app():
    app = FastAPI()
    app.mount("/static", StaticFiles(directory="static"), name="static")

    register_tortoise(
        app=app,
        db_url="postgres://postgres:1234@localhost:5432/ecommerce_db",
        modules={"models": ["core.models"]},
        generate_schemas=True,
        add_exception_handlers=True,
    )
    app.include_router(router)
    return app

2. 避免循环导入 #

确保core/models.py里不要导入signals模块，否则会出现循环引用，导致模型类加载不全、信号注册失败。信号模块依赖models是正常的，反过来依赖就会出问题。

3. 修正信号里的逻辑bug #

你信号里创建业务对象用了UserModel.create，但传入的business_name、owner_id字段明显不属于用户模型，应该替换成你定义的对应业务模型类，否则导包问题修复后会报字段不存在的错误。

Tortoise的信号本身没有特殊的注册流程，@post_save装饰器本质是在模块加载时把处理函数绑定到对应模型类的信号列表里，只要模块被正确导入、绑定的模型类和Tortoise初始化用的是同一个类对象，信号就会正常触发，不需要额外的注册API。

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