jest-dynamodb在Gitlab CI中运行失败，报错connect ECONNREFUSED ::1:8000

以下是针对该问题的实用排查和解决步骤：

• 强制使用IPv4地址
  错误显示连接IPv6回环地址::1:8000被拒绝，多数CI环境默认禁用IPv6。将代码中DynamoDB客户端的端点从localhost:8000改为127.0.0.1:8000，强制走IPv4连接：

  const client = new DynamoDBClient({
    endpoint: 'http://127.0.0.1:8000',
    region: 'local',
    credentials: {
      accessKeyId: 'fakeMyKeyId',
      secretAccessKey: 'fakeSecretAccessKey'
    }
  });
  

• 确保DynamoDB Local完全启动后再执行测试
  CI环境资源有限，DynamoDB启动速度可能慢于本地，导致测试提前执行。可通过以下方式处理：

  1. 安装wait-on工具等待服务就绪：

     npm install wait-on --save-dev
     

  2. 修改package.json测试脚本：

     "scripts": {
       "test": "wait-on http://127.0.0.1:8000 && jest"
     }
     

  3. 或在jest-dynamodb-config.js中延长启动超时：

     module.exports = {
       dynamodb: {
         start: {
           port: 8000,
           inMemory: true,
           migrate: true,
           timeout: 30000 // 延长至30秒
         }
       }
     };
     

• 调整Gitlab CI的服务配置（Docker executor场景）
  如果使用Docker类型的runner，直接本地启动DynamoDB可能存在网络隔离问题。建议通过Gitlab CI的services参数单独启动DynamoDB服务：

  test:
    stage: test
    image: node:18
    services:
      - name: amazon/dynamodb-local:latest
        alias: dynamodb
    script:
      - npm install
      - npm test
  

  同时将DynamoDB端点改为http://dynamodb:8000，利用Gitlab CI的服务别名解析访问。

• 验证DynamoDB启动状态
  在CI脚本中加入日志和验证步骤，确认服务是否正常启动：

  script:
    - npm install
    - npx dynamodb-local -p 8000 &
    - sleep 10
    - curl http://127.0.0.1:8000
    - npm test
  

  通过curl命令的输出判断服务是否可访问，结合日志排查启动失败原因。

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