You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Django集成Localstack遭遇EndpointConnectionError求助排查

Django应用配置Localstack连接S3失败问题排查

背景与现有配置

我正在为Django应用配置Localstack,实现本地开发时无需连接真实S3服务。

Docker Compose配置

app:
    build:
      context: .
      dockerfile: docker/app.Dockerfile
    command: >
      bash -c "poetry run python manage.py runserver_plus 0.0.0.0:8000 --reloader-type watchdog"
    ports:
      - 8000:8000
      - 5678:5678
    volumes:
      - .:/app
      - venv:/app/.venv
    depends_on:
      - db
      - celery
      - elasticsearch
      - localstack
    stdin_open: true
    tty: true
    networks:
      - proxynet

  localstack:
    container_name: localstack
    image: localstack/localstack
    ports:
      - '4566:4566'
    volumes:
      - ./localstack-data:/var/lib/localstack
      - /var/run/docker.sock:/var/run/docker.sock

Django settings.py配置

MEDIA_URL = "/media/"
MEDIA_ROOT = BASE_DIR("media")
DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
AWS_DEFAULT_ACL = "private"
AWS_S3_ACCESS_KEY_ID = "local"
AWS_S3_SECRET_ACCESS_KEY = "local"
AWS_S3_ENDPOINT_URL = "http://localhost:4566"
AWS_STORAGE_BUCKET_NAME = "mybucket"

问题现象

在应用中上传文件时始终报错:
botocore.exceptions.EndpointConnectionError: Could not connect to the endpoint URL: "http://localhost:4566/mybucket"

注:该问题仅在Django请求响应周期内发起S3请求时出现,我编写的脚本可以正常连接Localstack,脚本示例如下:

#!/bin/bash

export AWS_ACCESS_KEY_ID=local
export AWS_SECRET_ACCESS_KEY=local
export AWS_DEFAULT_REGION=us-east-1

aws s3api create-bucket --bucket "$1" --endpoint-url http://localhost:4566

# 检查桶创建是否成功
if [ $? -eq 0 ]; then
    echo "Bucket '$1' created successfully."
else
    echo "Failed to create bucket '$1'."
fi

已尝试的解决方案

  • 将端点URL改为http://localhost:4566和http://localstack:4566,均出现相同的ConnectionError
  • 自定义简化版的S3Boto3Storage类,问题仍未解决

依赖版本说明

使用的是较旧版本的依赖包:Django 3.2.0 和 django-storages 1.9.1

提问

请问我遗漏了什么配置?


内容的提问来源于stack exchange,提问作者Dillon Brock

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.16 20:10:57