Nest应用开启Sequelize synchronize=true时无法连接PostgreSQL

我已通过Docker成功部署并运行PostgreSQL容器，相关配置如下：

环境变量文件 #

POSTGRES_HOST="localhost"
POSTGRES_PORT=5432
POSTGRES_USERNAME="postgres"
POSTGRES_PASSWORD="123"
POSTGRES_DATABASE="netabe"

docker-compose.yml 文件 #

postgres:
    container_name: postgres_container
    image: 'postgres:latest'
    environment:
      POSTGRES_USER: ${POSTGRES_USERNAME}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DATABASE}
    ports:
      - 5432:5432
    networks:
      app_network:
        ipv4_address: 172.26.0.10
    restart: unless-stopped
    healthcheck:
      test: ['CMD', 'pg_isready -U postgres']
      interval: 5s
      timeout: 5s
      retries: 5
    volumes:
      - postgres:/data/postgres

PostgreSQL容器运行正常，数据库已创建，但执行NODE_ENV=development nest start --watch启动Nest应用时，控制台报错：

[Nest] 13620  - 05/01/2023, 6:56:41 pm   ERROR [SequelizeModule] Unable to connect to the database. Retrying (1)....

我的Nest应用通过PostgresDatabaseProviderModule引入Sequelize配置，代码如下：

@Module({
  imports: [
    SequelizeModule.forRootAsync({
      imports: [PostgresConfigModule],
      useFactory: async (postgresConfigService: PostgresConfigService) => ({
        dialect: 'postgres' as string,
        host: postgresConfigService.host as string,
        port: postgresConfigService.port,
        username: postgresConfigService.username,
        password: postgresConfigService.password,
        database: postgresConfigService.database,
        keepConnectionAlive: true,
        synchronize: true,
        autoLoadModels: true,
      }),
      inject: [PostgresConfigService],
    } as SequelizeModuleAsyncOptions),
  ],
})
export class PostgresDatabaseProviderModule {}

经排查，问题与Docker无关，仅当synchronize设为true时出现连接报错，设为false则连接正常，请问该问题的原因是什么？

当synchronize: true时，Sequelize会自动执行模型与数据库结构的同步操作，这个过程对数据库的要求远高于单纯建立连接，核心原因集中在以下几点：

1. 数据库用户权限不足
   连接用户（postgres）虽然能正常建立数据库连接，但缺少执行表创建、修改、删除等DDL操作的权限。开启synchronize后，Sequelize需要执行这些操作，权限不足会被包装为连接失败的错误抛出。

2. 模型定义存在语法或逻辑错误
   如果实体模型的字段类型、关联配置等不符合PostgreSQL规范（比如使用了PostgreSQL不支持的数据类型、关联关系循环引用），同步过程会触发数据库层面的错误，进而被捕获为连接异常。而synchronize: false时不会执行同步，因此不会暴露这类问题。

3. 数据库已有表结构与模型冲突
   数据库中已存在同名表，但表结构与当前模型定义不匹配，Sequelize的自动同步逻辑无法处理这种冲突，导致同步失败并抛出类似连接错误的异常。

4. Sequelize与PostgreSQL版本不兼容
   使用的Sequelize版本与PostgreSQL版本不匹配，同步时执行的SQL语句在当前PostgreSQL版本中不被支持，引发底层错误，最终表现为连接失败。

• 检查用户权限：确认postgres用户拥有目标数据库的CREATE、ALTER、DROP等DDL权限。
• 核对模型定义：逐一检查实体模型的字段类型、关联配置，确保符合PostgreSQL的语法要求。
• 开启详细日志：在Sequelize配置中添加logging: console.log，查看同步过程中执行的具体SQL语句及错误信息，定位问题根源。
• 验证版本兼容性：确认Sequelize版本与PostgreSQL版本的兼容性（例如最新版Sequelize通常要求PostgreSQL 12及以上版本）。

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