LocalStack+DynamoDB本地Jest测试报两类异常，CI环境正常求助

问题描述 #

本地运行开发团队提供的Jest测试套件时，所有涉及DynamoDB的测试均失败，同时出现两类互斥错误：

• ResourceNotFoundException: Cannot do operations on a non-existent table
• ResourceInUseException: Cannot create preexisting table

相同的docker-compose.yml配置在Circle CI中运行完全正常，本地执行aws --endpoint-url=http://localhost:4569 dynamodb list-tables返回空列表[]，更新LocalStack镜像后问题依旧。

当前使用的docker-compose.yml配置：

version: '3.3'

services:
  localstack:
    image: localstack/localstack:0.9.4
    ports:
      - '4569:4569'
      - '4572:4572'
      - '4576:4576'
      - '4584:4584'
    environment:
      - SERVICES=dynamodb,s3,secretsmanager,sqs
      - DOCKER_HOST=unix:///var/run/docker.sock
      - DEFAULT_REGION=ap-northeast-1

可能的原因及解决方案 #

1. 测试并行执行引发表操作竞争 #

Jest默认并行运行测试用例，多个测试同时对同一个表执行创建/删除操作时，会出现时序冲突：比如A测试检查表不存在后准备创建，此时B测试已经完成表创建，导致A抛出“表已存在”错误；或者A测试删除了表，B测试仍在操作该表，抛出“表不存在”错误。

解决方法：

• 修改Jest配置禁用并行执行，在jest.config.js中添加：

module.exports = {
  maxWorkers: 1,
};

• 给每个测试用例的表名添加唯一前缀（比如随机字符串），确保不同测试操作独立的表资源。

2. LocalStack服务未就绪就执行测试 #

本地机器性能可能弱于Circle CI的运行环境，LocalStack的DynamoDB服务还未完全启动，测试就已开始执行：初期表创建请求失败，后续重试时又因延迟生效的创建请求导致表已存在。

解决方法：

• 给LocalStack添加健康检查，确保服务就绪后再启动测试：
  修改docker-compose.yml，给localstack服务增加健康检查配置：

  localstack:
    # 原有配置保持不变
    healthcheck:
      test: ["CMD", "curl", "-s", "http://localhost:4569/health", "|", "grep", "\"dynamodb\": \"running\""]
      interval: 5s
      timeout: 10s
      retries: 5
  

• 在测试脚本中添加等待逻辑，比如执行测试前先运行等待脚本：

  #!/bin/bash
  until curl -s http://localhost:4569/health | grep -q "\"dynamodb\": \"running\""; do
    echo "等待LocalStack DynamoDB就绪..."
    sleep 2
  done
  

3. 本地DynamoDB客户端配置不一致 #

检查测试代码中的DynamoDB客户端是否正确指向LocalStack端点，且区域与docker-compose.yml中的DEFAULT_REGION一致。

解决方法：

• 确认客户端初始化代码符合以下格式：

const { DynamoDB } = require('aws-sdk');
const dynamodb = new DynamoDB({
  endpoint: 'http://localhost:4569',
  region: 'ap-northeast-1',
  accessKeyId: 'fakeMyKeyId', // LocalStack无需真实密钥，任意填写即可
  secretAccessKey: 'fakeSecretAccessKey',
});

4. LocalStack容器残留数据干扰 #

本地容器可能保留了之前测试的残留数据，导致表状态混乱。

解决方法：

• 彻底清理容器及关联卷后重新启动：

docker-compose down -v
docker-compose up -d

• 在测试结束后添加清理逻辑，删除所有测试创建的表资源。

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