Docker部署Django至DigitalOcean时静态文件收集及S3存储问题

问题背景 #

将Docker化的Django应用部署到DigitalOcean时，执行collectstatic命令失败，本地项目包含存放静态文件的static文件夹，目标是将静态文件存储到Amazon S3桶的staticfiles目录或DigitalOcean Spaces的对应目录。

报错分析 #

核心错误为：

TypeError: expected string or bytes-like object

该错误发生在botocore验证Bucket名称时，说明AWS_STORAGE_BUCKET_NAME环境变量未被正确加载，值为None。原因是Docker构建/运行阶段未传入所需环境变量，导致Django的settings.py中通过os.getenv()获取的配置为空。

解决步骤 #

1. 确保Docker能获取环境变量 #

方法一：构建时通过--build-arg传入

修改Dockerfile，添加环境变量参数：

FROM python:3.10
ENV PYTHONUNBUFFERED=1

# 添加构建参数
ARG AWS_ACCESS_KEY_ID
ARG AWS_SECRET_ACCESS_KEY
ARG AWS_STORAGE_BUCKET_NAME
ARG AWS_S3_ENDPOINT_URL

# 将构建参数转为环境变量
ENV AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID
ENV AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY
ENV AWS_STORAGE_BUCKET_NAME=$AWS_STORAGE_BUCKET_NAME
ENV AWS_S3_ENDPOINT_URL=$AWS_S3_ENDPOINT_URL

WORKDIR /code

# Install build dependencies
RUN apt-get update && apt-get install -y tzdata libpython3-dev gcc

# Upgrade pip and setuptools
RUN pip install --upgrade pip setuptools

# Copy requirements and install dependencies
COPY requirements.txt .
RUN pip install -r requirements.txt

# Copy the rest of the application files
COPY . .

# Collect static files
RUN python manage.py collectstatic --noinput

EXPOSE 8004
CMD ["python", "manage.py", "runserver", "0.0.0.0:8004"]

构建镜像时传入参数：

docker build \
  --build-arg AWS_ACCESS_KEY_ID=你的密钥ID \
  --build-arg AWS_SECRET_ACCESS_KEY=你的密钥 \
  --build-arg AWS_STORAGE_BUCKET_NAME=你的桶名称 \
  --build-arg AWS_S3_ENDPOINT_URL=你的端点URL \
  -t django-app .

方法二：容器启动时执行collectstatic（推荐）

将collectstatic移到容器启动阶段，避免敏感信息留在镜像中，同时适配运行时环境变量：
修改Dockerfile的CMD部分：

# 移除原有的RUN python manage.py collectstatic --noinput
EXPOSE 8004
CMD ["sh", "-c", "python manage.py collectstatic --noinput && python manage.py runserver 0.0.0.0:8004"]

运行容器时传入环境变量：

docker run \
  -e AWS_ACCESS_KEY_ID=你的密钥ID \
  -e AWS_SECRET_ACCESS_KEY=你的密钥 \
  -e AWS_STORAGE_BUCKET_NAME=你的桶名称 \
  -e AWS_S3_ENDPOINT_URL=你的端点URL \
  -p 8004:8004 django-app

2. 修复settings.py配置 #

• 给环境变量添加默认值，避免空值导致报错：

AWS_ACCESS_KEY_ID = os.getenv("AWS_ACCESS_KEY_ID", "")
AWS_SECRET_ACCESS_KEY = os.getenv("AWS_SECRET_ACCESS_KEY", "")
AWS_STORAGE_BUCKET_NAME = os.getenv("AWS_STORAGE_BUCKET_NAME", "")
AWS_S3_ENDPOINT_URL = os.getenv("AWS_S3_ENDPOINT_URL", "")

• 针对DigitalOcean Spaces，确保AWS_S3_ENDPOINT_URL格式正确（例如https://nyc3.digitaloceanspaces.com，根据你的区域调整）
• 同步STATIC_URL与存储服务路径：

STATIC_URL = f"{AWS_S3_ENDPOINT_URL}/{AWS_LOCATION}/"

3. 验证存储服务权限 #

• 确保Access Key拥有目标存储桶的权限：s3:PutObject、s3:GetObject、s3:ListBucket
• DigitalOcean Spaces用户需在控制面板中为该Access Key分配对应Spaces的读写权限

验证方法 #

1. 运行容器后，检查S3/Spaces的static目录（对应AWS_LOCATION配置）是否已上传静态文件
2. 访问应用页面，确认CSS、JS等静态资源能正常加载

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