GitHub Actions执行PostgreSQL迁移时遇read ETIMEDOUT错误求助

我们使用TypeORM执行PostgreSQL数据库迁移，本地环境运行仅需1-2分钟，完全正常，但在GitHub Actions流水线中执行相同脚本时，会出现以下问题：

• 迁移步骤耗时5-7分钟后抛出read ETIMEDOUT错误
• 凭证确认正确（极低概率执行成功）
• 已将AWS RDS参数组中的statement_timeout调至最大值，迁移运行时间延长至随机20分钟左右，但仍会失败
• 相同迁移在AWS CodeBuild中运行完全正常，推测是GitHub Actions的网络稳定性/速度问题导致

流水线配置如下：

name: Staging migrations pipeline
on:
  push:
    branches:
      - staging

env:
  NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
  NPM_EMAIL: ${{ secrets.NPM_EMAIL }}
  POSTGRES_HOST: staging-db.xxxxxxxx.us-east-2.rds.amazonaws.com
  POSTGRES_PORT: 5432
  POSTGRES_USER: ${{ secrets.POSTGRES_STAGE_USER }}
  POSTGRES_PASSWORD: ${{ secrets.POSTGRES_STAGE_PASSWORD }}
  POSTGRES_DATABASE: sync-db

jobs:
  deploy:
    runs-on: ubuntu-20.04
    steps:
      - name: Clone repo
        uses: actions/checkout@v2

      - name: Install packages
        run: npm install
      
      - name: Run migration
        run: npm run migration:run

      - name: Building the project
        run: npm run build

      - name: Update version
        run: |
          git config --global user.email "${NPM_EMAIL}"
          git config --global user.name "cicd"
          npm version patch -m "[skip ci]-new version" --force
      - name: Push tags
        run: git push origin && git push origin --tags

      - name: Publish version
        run: npm publish

可能的解决方案 #

1. 优化GitHub Actions与AWS RDS的网络连接 #

GitHub Actions运行在Azure服务器上，跨云厂商的网络延迟是核心问题之一：

• 添加GitHub Actions出站IP到RDS安全组：GitHub会定期更新出站IP列表，将这些IP段添加到RDS安全组的入站规则中，避免动态IP的网络限制导致连接不稳定
• 使用AWS自托管GitHub运行器：在AWS EC2实例上部署GitHub自托管运行器，让迁移脚本在AWS内部网络执行，彻底消除跨云网络延迟
• 配置跨云网络互联：通过AWS VPC peering或中转网关连接Azure与AWS，建立低延迟的专用网络通道（适合有运维能力的团队）

2. 优化TypeORM迁移脚本与连接配置 #

跨云网络下，小的性能问题会被放大，可针对性优化：

• 拆分大迁移文件：如果单条迁移包含批量数据操作（如大量插入/更新），拆分成多个小迁移，减少单次连接的负载
• 启用迁移日志调试：在TypeORM配置中开启详细日志，定位迁移过程中耗时最长的步骤，针对性优化
• 调整数据库连接池参数：延长连接超时时间，适配跨云网络延迟：

  // data-source.ts示例配置
  export const AppDataSource = new DataSource({
    type: "postgres",
    host: process.env.POSTGRES_HOST,
    port: parseInt(process.env.POSTGRES_PORT),
    username: process.env.POSTGRES_USER,
    password: process.env.POSTGRES_PASSWORD,
    database: process.env.POSTGRES_DATABASE,
    synchronize: false,
    logging: true,
    entities: ["src/entities/**/*.ts"],
    migrations: ["src/migrations/**/*.ts"],
    subscribers: [],
    pool: {
      max: 10,
      min: 2,
      acquireTimeoutMillis: 60000, // 延长连接获取超时
      connectTimeoutMillis: 30000, // 延长连接建立超时
    },
  });
  

3. 给迁移步骤添加重试机制 #

针对偶尔成功的情况，利用GitHub Actions的重试动作提升成功率：

- name: Run migration with retry
  uses: nick-fields/retry@v2
  with:
    timeout_minutes: 30
    max_attempts: 3
    command: npm run migration:run

4. 调整RDS网络相关参数 #

除statement_timeout外，可尝试调整以下参数优化跨云连接稳定性：

• idle_in_transaction_session_timeout：设置长事务超时时间，避免闲置连接占用资源
• tcp_keepalives_idle、tcp_keepalives_interval：调整TCP心跳参数，保持连接活跃

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