新建Serverpod项目启动时出现PostgreSQL数据库连接错误

• 执行数据库迁移
  进入项目根目录，运行以下命令创建Serverpod所需的基础数据表：

  dart run serverpod migrate
  

  该命令会自动生成包括serverpod_runtime_settings在内的核心表结构。

• 验证容器与数据库状态

  1. 确认PostgreSQL容器正常运行：

     docker ps
     

     确保容器状态显示为Up。
  2. 进入容器检查数据库表：

     docker exec -it <postgres容器名> psql -U <用户名> -d <数据库名>
     

     替换命令中的占位符为项目配置值（默认多为serverpod相关），进入数据库后执行\dt查看表列表，确认serverpod_runtime_settings是否存在。

• 重置数据库（仅全新项目适用）
  如果迁移无效，可清空数据库重新初始化：

  1. 停止并删除PostgreSQL容器：

     docker stop <postgres容器名>
     docker rm <postgres容器名>
     

  2. 删除关联的数据卷（会清空所有数据）：

     docker volume rm <postgres数据卷名>
     

  3. 重启容器并重新执行迁移：

     docker-compose up -d
     dart run serverpod migrate
     

• 核对项目配置
  检查config/config.yaml中的数据库连接信息（主机、端口、用户名、密码、数据库名），确保与Docker容器的配置完全匹配，避免因连接错误导致迁移未生效。

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