Spring Boot容器无法连接LocalStack容器的配置求助

1. Docker网络配置说明 #

Docker Compose默认会为当前项目自动创建一个专属桥接网络，所有services下的容器都会自动加入这个网络。因此不需要手动创建网络，容器之间可以直接通过服务名（比如localstack）互相访问——不要用localhost，容器内的localhost指向自身，无法访问其他容器。

如果想增强配置可读性，也可以显式声明网络（效果和默认一致），参考下方修改后的docker-compose.yml。

2. SQS URL与连接配置 #

要让Spring Boot应用连接到LocalStack的SQS，核心是调整访问地址和队列URL：

• 容器内访问LocalStack必须用服务名localstack作为主机，而非localhost
• LocalStack的SQS队列URL格式为：http://localstack:4566/000000000000/<queue-name>，其中000000000000是LocalStack接受的默认AWS账户ID（任意值均可）

修改后的配置文件 #

docker-compose.yml

version: "3.8"
services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    image: my-spring-app
    container_name: spring-app
    ports:
      - "8080:8080"
    environment:
      - AWS_ACCESS_KEY_ID=12345
      - AWS_SECRET_ACCESS_KEY=12345
      - AWS_REGION=us-east-1
    depends_on:
      - localstack
    networks:
      - app-network
  
  localstack:
    image: localstack/localstack:latest
    container_name: localstack
    environment:
      - SERVICES=sqs
      - DEBUG=1
      - AWS_DEFAULT_REGION=us-east-1
      # 可选：启动时自动创建FIFO队列
      - COMMAND="awslocal sqs create-queue --queue-name sample-queue.fifo --attributes FifoQueue=true"
    ports:
      - "4566:4566"
    volumes:
      - "/tmp/localstack:/tmp/localstack"
    networks:
      - app-network

networks:
  app-network:
    driver: bridge

application.yml（Spring Boot）

cloud:
  aws:
    stack:
      auto: false
    region:
      static: us-east-1
      auto: false
    credentials:
      access-key: 12345
      secret-key: 12345
    sqs:
      # 指定LocalStack的SQS端点
      endpoint: http://localstack:4566
    queue:
      # 完整的SQS队列URL
      url: http://localstack:4566/000000000000/sample-queue.fifo

3. 额外注意事项 #

• depends_on仅保证容器启动顺序，不保证LocalStack的SQS服务完全就绪。如果Spring Boot启动时SQS还没准备好，会出现连接失败，可添加重试机制（比如Spring的@Retryable）或使用启动等待脚本。
• 确保Spring Boot项目引入了正确的依赖，比如spring-cloud-starter-aws-messaging。
• 如果没有通过COMMAND自动创建队列，需要手动进入LocalStack容器执行创建命令：

  docker exec -it localstack awslocal sqs create-queue --queue-name sample-queue.fifo --attributes FifoQueue=true
  

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