Docker环境下Tortoise-ORM连接PostgreSQL被拒绝问题求助

一、先解决Docker后端连接PostgreSQL的ConnectionRefusedError #

• 核对docker-compose服务名与数据库主机配置：PostgreSQL服务在docker-compose里的名称（比如db）必须和后端TORTOISE_ORM配置中的数据库主机一致，不能用localhost或本地IP——容器内的localhost指向自身，无法访问宿主机或其他容器。
• 确保PostgreSQL完全启动后再启动后端：在docker-compose.yml给后端添加依赖与健康检查，避免后端启动时PostgreSQL还未就绪：

  services:
    db:
      image: postgres:15
      healthcheck:
        test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
        interval: 5s
        timeout: 5s
        retries: 5
    backend:
      build: ./backend
      depends_on:
        db:
          condition: service_healthy
  

• 验证环境变量是否正确传递：进入后端容器执行echo $TORTOISE_ORM，确认数据库URL的主机、端口、用户名、密码与postgres服务的配置完全匹配（默认端口是5432，别写错）。
• 检查PostgreSQL容器状态：执行docker-compose ps查看db服务是否正常运行，或docker-compose logs db查看启动日志，排除密码错误、数据目录权限问题等启动故障。

二、解决Tortoise-ORM未创建表的问题 #

• 确认已执行表生成逻辑：Tortoise不会自动建表，必须显式调用await Tortoise.generate_schemas()。在FastAPI中通常在启动事件里添加：

  from fastapi import FastAPI
  from tortoise.contrib.fastapi import register_tortoise
  
  app = FastAPI()
  
  @app.on_event("startup")
  async def startup():
      await Tortoise.generate_schemas()
  
  register_tortoise(
      app,
      config=TORTOISE_ORM,
      generate_schemas=False,  # 手动调用生成，避免重复执行
  )
  

• 检查模型是否注册到配置：TORTOISE_ORM的models列表必须包含所有需要建表的模型所在模块，比如你的模型在app.models下，配置要写"models": ["app.models"]（用aerich迁移的话再加"aerich.models"）。
• 确认数据库用户权限：postgres的POSTGRES_USER需要有目标数据库的CREATE权限，默认超级用户具备该权限，自定义用户需提前配置权限。
• 查看后端启动日志：检查日志中是否有Tortoise相关报错，比如模型字段类型错误、关系配置不当等，这类问题会导致表生成失败但可能无明显提示。

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